ListControl.DataTextFormatString Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a cadeia de caracteres de formatação usada para controlar como os dados associados ao controle de lista são exibidos.
public:
virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };public virtual string DataTextFormatString { get; set; }[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }member this.DataTextFormatString : string with get, set[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, setPublic Overridable Property DataTextFormatString As StringValor da propriedade
A cadeia de caracteres de formatação para dados associados ao controle. O valor padrão é Empty.
- Atributos
Comentários
Use a DataTextFormatString propriedade para fornecer um formato de exibição personalizado para os itens em um controle de lista.
A cadeia de caracteres de formato de dados consiste em duas partes, separadas por dois-pontos, no formato { A : Bxx }. Por exemplo, a cadeia de {0:F2} caracteres de formatação formata a célula para exibir um número de ponto fixo com duas casas decimais.
Observação
A cadeia de caracteres inteira deve estar entre chaves para indicar que é uma cadeia de caracteres de formato e não uma cadeia de caracteres literal. Qualquer texto fora das chaves é exibido como texto literal.
O valor antes dos dois-pontos (A no exemplo geral) especifica o índice de parâmetro em uma lista de parâmetros com base em zero.
Observação
Esse valor só pode ser definido como 0 porque há apenas um valor em cada célula.
O caractere após os dois-pontos (B no exemplo geral) especifica o formato no qual exibir o valor. A tabela a seguir lista os formatos comuns.
| Caractere de formato | Descrição |
|---|---|
C |
Exibe valores numéricos no formato de moeda. |
D |
Exibe valores numéricos no formato decimal. |
E |
Exibe valores numéricos no formato científico (exponencial). |
F |
Exibe valores numéricos em formato fixo. |
G |
Exibe valores numéricos em formato geral. |
N |
Exibe valores numéricos no formato de número. |
X |
Exibe valores numéricos no formato hexadecimal. |
Observação
O caractere de formato não diferencia maiúsculas de minúsculas, exceto por X, que exibe os caracteres hexadecimal no caso especificado.
O valor após o caractere de formato (xx no exemplo geral) especifica o número de dígitos significativos ou casas decimais a serem exibidas.
A tabela a seguir contém exemplos de cadeias de caracteres de formatação e os resultados. Ele pressupõe configurações de inglês padrão.
| Valor numérico | Cadeia de formato | Resultado |
|---|---|---|
| 12345.6789 | {0:C} | \$12.345,68 |
| -12345.6789 | {0:C} | (\$12.345,68) |
| 12345 | {0:D} | 12345 |
| 12345 | {0:D8} | 00012345 |
| 12345.6789 | {0:E} | 1234568E+004 |
| 12345.6789 | {0:E10} | 1,2345678900E+004 |
| 12345.6789 | {0:F} | 12345.68 |
| 12345.6789 | {0:F0} | 12346 |
| 12345.6789 | {0:G} | 12345.6789 |
| 123456789 | {0:G7} | 1,234568E8 |
| 12345.6789 | {0:N} | 12,345.68 |
| 123456789 | {0:N4} | 123,456,789.0000 |
| 12345.6789 | "Total: {0:C}" | Total: \$12345,68 |
Para obter mais informações sobre a formatação de cadeias de caracteres, consulte Tipos de Formatação.
O valor dessa propriedade é armazenado no estado de exibição.
Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.
Aplica-se a
Confira também
- tipos de formatação no .NET
