BoundField.DataFormatString Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define a cadeia que especifica o formato de exibição para o valor do campo.

public:
 virtual property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataFormatString { get; set; }
member this.DataFormatString : string with get, set
Public Overridable Property DataFormatString As String

Valor de Propriedade

String

Uma cadeia de formatação que especifica o formato de exibição para o valor do campo. O padrão é uma cadeia vazia (""), o que indica que não é aplicada qualquer formatação especial ao valor do campo.

Observações

Use a DataFormatString propriedade para especificar um formato de exibição personalizado para os valores que são apresentados no BoundField objeto. Se a DataFormatString propriedade não estiver definida, o valor do campo é exibido sem qualquer formatação especial.

Note

Nas versões de ASP.NET anteriores à 3.5, é necessário definir a propriedade HtmlEncode para false para formatar campos que não são tipos de dados em cadeia. Caso contrário, o valor do campo é convertido para uma cadeia pelo método de conversão padrão antes de a cadeia de formato armazenada na DataFormatString propriedade ser aplicada.

Por defeito, a cadeia de formatação é aplicada ao valor do campo apenas quando o controlo limitado por dados que contém o BoundField objeto está em modo apenas de leitura. Para aplicar a string de formatação aos valores dos campos enquanto estiver em modo de edição, defina a ApplyFormatInEditMode propriedade para true.

A cadeia de formatação pode ser qualquer cadeia literal e normalmente inclui um marcador para o valor do campo. Por exemplo, na cadeia Item Value: {0}de formatação , o valor do campo é substituído pelo {0} marcador quando a cadeia é exibida no BoundField objeto. O resto da cadeia de formatação é apresentado como texto literal.

Se a cadeia de formatação não incluir um marcador de posição, apenas a cadeia de formatação é incluída no texto final de exibição (o valor do campo da fonte de dados não é incluído). Se o marcador for um 0 (zero) contido em colchetes curvados, como mostrado no exemplo anterior, o valor do campo é convertido para uma cadeia pelo método padrão. Pode adicionar ao zero uma cadeia que especifica como o valor do campo deve ser formatado. Por exemplo, o marcador {0:C} de posição para um campo numérico especifica que o valor do campo deve ser convertido para um formato de moeda.

A formatação é aplicada utilizando o Format método. O número que segue a chave curva esquerda faz parte da sintaxe usada por esse método e indica qual de uma série de valores o marcador deve usar. Como existe apenas um valor de campo em cada célula, o número que segue a órtese enrolada esquerda só pode ser definido para 0.

A tabela seguinte lista os caracteres de formato padrão para campos numéricos. Estes caracteres de formato não distinguem maiúsculas e minúsculas, exceto , Xque apresenta caracteres hexadecimais no caso especificado. Pode adicionar um número à maioria dos caracteres de formato para especificar quantos dígitos significativos ou casas decimais pretende mostrar.

Note

Na maioria dos casos, a formatação depende da configuração cultural do servidor. Os exemplos são para um contexto cultural de en-US.

Carácter de formato Description Example
C ou c Apresenta valores numéricos em formato de moeda. Pode especificar o número de casas decimais. Formato: {0:C}

123.456 -> \$123.46

Formato: {0:C3}

123.456 -> \$123.456
D ou d Apresenta valores inteiros em formato decimal. Pode especificar o número de dígitos. (Embora o tipo seja referido como "decimal", os números são formatados como inteiros.) Formato: {0:D}

1234 -> 1234

Formato: {0:D6}

1234 -> 001234
E ou e Apresenta valores numéricos em formato científico (exponencial). Pode especificar o número de casas decimais. Formato: {0:E}

1052.0329112756 -> 1.052033E+003

Formato: {0:E2}

-1052.0329112756 -> -1.05e+003
F ou f Apresenta valores numéricos em formato fixo. Pode especificar o número de casas decimais. Formato: {0:F}

1234.567 -> 1234.57

Formato: {0:F3}

1234.567 -> 1234.567
G ou g Apresenta valores numéricos em formato geral (os mais compactos de notação de ponto fixo ou científica). Pode especificar o número de dígitos significativos. Formato: {0:G}

-123.456 -> -123.456

Formato: {0:G2}

-123.456 -> -120
N ou n Apresenta valores numéricos em formato numérico (incluindo separadores de grupo e sinal negativo opcional). Pode especificar o número de casas decimais. Formato: {0:N}

1234.567 -> 1.234,57

Formato: {0:N4}

1234.567 -> 1.234.5670
P ou p Apresenta valores numéricos em formato percentual. Pode especificar o número de casas decimais. Formato: {0:P}

1 -> 100,00%

Formato: {0:P1}

0,5 -> 50,0%
R ou r Apresenta Single, Double, ou BigInteger valores em formato de ida e volta. Formato: {0:R}

123456789.12345678 -> 123456789.12345678
X ou x Apresenta valores inteiros em formato hexadecimal. Pode especificar o número de dígitos. Formato: {0:X}

255 -> FF

Formato: {0:x4}

255 -> 00ff

Para mais informações e exemplos que mostram a formatação de outros valores de cultura, consulte Cadeias de Formato Numérico Padrão. Também podes criar cadeias de formatos numéricos personalizadas. Para mais informações, consulte Cadeias de Formatos Numéricos Personalizados.

A tabela seguinte lista caracteres de formato para DateTime campos. A maioria destas especificações de formatação resulta numa saída diferente dependendo das configurações culturais. Os exemplos são para um DateTime valor de 15/06/2009 13:45:30 com uma definição de cultura de en-US.

Carácter de formato Description Example
d Padrão de data curto. Formato: {0:d}

15/06/2009 13:45:30 -> 15/06/2009
D Padrão de data longa. Formato: {0:D}

15/06/2009 13:45:30 -> Segunda-feira, 15 de junho de 2009
f Padrão de data/hora completa (tempo curto). Formato: {0:f}

15/06/2009 13:45:30 -> Segunda-feira, 15 de junho de 2009 13:45
F Padrão de data/hora completa (tempo longo). Formato: {0:F}

15/06/2009 13:45:30 -> Segunda-feira, 15 de junho de 2009 13:45:30
g Padrão geral de data/hora (tempo curto). Formato: {0:g}

15/06/2009 13:45:30 -> 15/06/2009 13:45
G Padrão geral de data/hora (tempo longo). Formato: {0:G}

15/06/2009 13:45:30 -> 15/06/2009 13:45:30
M ou m Padrão mês/dia. Formato: {0:M}

15/06/2009 13:45:30 -> 15 de junho
O ou o Padrão de data/hora da viagem de ida e volta. Formato: {0:o}

15/06/2009 13:45:30 -> 2009-06-15T13:45:30.0900000
R ou r RFC1123 padrão (para informações, ver DateTimeFormatInfo.RFC1123Pattern). Formato: {0:R}

15/06/2009 13:45:30 -> Seg, 15 Jun 2009 20:45:30 GMT
s Padrão de data/hora classificável. Formato: {0:s}

15/06/2009 13:45:30 -> 2009-06-15T13:45:30
t Padrão de tempo curto. Formato: {0:t}

15/06/2009 13:45:30 -> 13:45
T Padrão de tempo longo. Formato: {0:T}

15/06/2009 13:45:30 -> 13:45:30
u Padrão universal de data/hora classificável. Formato: {0:u}

15/06/2009 13:45:30 -> 2009-06-15 20:45:30Z
U Padrão universal de data/hora completa. Formato: {0:U}

15/06/2009 13:45:30 -> Segunda-feira, 15 de junho de 2009 20:45:30
Y ou y Padrão do mês do ano. Formato: {0:Y}

15/06/2009 13:45:30 -> Junho de 2009

Para mais informações e exemplos que mostram a formatação de outros valores culturais, consulte Cadeias de Formato Padrão de Data e Hora. Também pode criar cadeias de formatos personalizados de data e hora. Para mais informações, consulte Cadeias de Formato de Data e Hora Personalizadas.

Aplica-se a

Ver também