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 os dados associados ao controle. O valor padrão é Empty.
- Atributos
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.
