ListControl.DataTextFormatString Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a cadeia de formatação usada para controlar como os dados atribuídos ao controlo da 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 de Propriedade
A cadeia de formatação dos dados atribuídos ao controlo. O valor predefinido é Empty.
- Atributos
Observações
Use a DataTextFormatString propriedade para fornecer um formato de exibição personalizado dos itens num controlo de lista.
A cadeia de formatos de dados consiste em duas partes, separadas por dois pontos, na forma { A : Bxx }. Por exemplo, a cadeia {0:F2} de formatação formataria a célula para mostrar um número de ponto fixo com duas casas decimais.
Note
Toda a cadeia deve ser encerrada em chaves para indicar que é uma cadeia de formato e não uma cadeia literal. Qualquer texto fora das colchetes é mostrado como texto literal.
O valor antes dos dois-pontos (A no exemplo geral) especifica o índice de parâmetros numa lista de parâmetros baseada em zero.
Note
Este valor só pode ser definido para 0 porque existe apenas um valor em cada célula.
O carácter após os dois-pontos (B no exemplo geral) especifica o formato em que o valor deve ser exibido. A tabela seguinte lista os formatos comuns.
| Carácter de formato | Description |
|---|---|
C |
Apresenta valores numéricos em formato de moeda. |
D |
Apresenta valores numéricos em formato decimal. |
E |
Apresenta valores numéricos em formato científico (exponencial). |
F |
Apresenta valores numéricos em formato fixo. |
G |
Apresenta valores numéricos em formato geral. |
N |
Apresenta valores numéricos em formato numérico. |
X |
Apresenta valores numéricos em formato hexadecimal. |
Note
O carácter de formato não distingue maiúsculas e minúsculas, exceto , Xque mostra os caracteres hexadecimais no caso especificado.
O valor após o carácter de formato (xx no exemplo geral) especifica o número de dígitos significativos ou casas decimais a mostrar.
A tabela seguinte contém exemplos de strings de formatação e os resultados. Assume as configurações padrão de inglês.
| Valor numérico | Formatar cadeia de caracteres | 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 mais informações sobre strings de formatação, consulte Tipos de Formatação.
O valor desta propriedade é armazenado no estado de visualização.
Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.