ListControl.DataTextFormatString Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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, set
Public Overridable Property DataTextFormatString As String

Valor da propriedade

String

A cadeia de caracteres de formatação para os dados associados ao controle. O valor padrão é Empty.

Atributos
ThemeableAttribute

Comentários

Use a DataTextFormatString propriedade para fornecer um formato de exibição personalizado dos 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 caracteres de formatação {0:F2} formataria 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 baseada 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 no 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 , Xque 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 padrão em inglês.

Valor numérico Cadeia de formato Resultado
12345.6789 "{0:C}" US$ 12.345,68
-12345.6789 "{0:C}" (US$ 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 mais informações sobre cadeias de caracteres de formatação, 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 Capas.

Aplica-se a

Confira também