BoundField.DataFormatString Propriedade

  • Referência

Definição

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

Obtém ou define a cadeia de caracteres que especifica o formato de exibição do 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 da propriedade

String

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

Exemplos

Um Visual Studio projeto de site da Web com código-fonte está disponível para acompanhar este tópico: Baixar.

O exemplo a seguir mostra como usar a DataFormatString propriedade para especificar um formato de exibição personalizado para os valores de um campo.

O exemplo a seguir mostra uma linha da saída produzida por este exemplo.

ProductID Nome ProductNumber ListPrice Peso ModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

Comentários

Use a DataFormatString propriedade para especificar um formato de exibição personalizado para os valores exibidos no BoundField objeto. Se a DataFormatString propriedade não estiver definida, o valor do campo será exibido sem nenhuma formatação especial.

Observação

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

Por padrão, a cadeia de caracteres de formatação é aplicada ao valor do campo somente quando o controle associado a dados que contém o BoundField objeto está no modo somente leitura. Para aplicar a cadeia de caracteres de formatação a valores de campo enquanto estiver no modo de edição, defina a ApplyFormatInEditMode propriedade como true.

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

Se a cadeia de caracteres de formatação não incluir um espaço reservado, somente a cadeia de caracteres de formatação em si será incluída no texto de exibição final (o valor do campo da fonte de dados não está incluído). Se o espaço reservado for um 0 (zero) entre chaves, conforme mostrado no exemplo anterior, o valor do campo será convertido em uma cadeia de caracteres pelo método padrão. Você pode acrescentar ao zero uma cadeia de caracteres que especifica como o valor do campo deve ser formatado. Por exemplo, o espaço reservado {0:C} para um campo numérico especifica que o valor do campo deve ser convertido em um formato de moeda.

A formatação é aplicada usando o Format método. O número que segue a chave à esquerda faz parte da sintaxe usada por esse método e indica qual de uma série de valores o espaço reservado deve usar. Como há apenas um valor de campo em cada célula, o número que segue a chave esquerda só pode ser definido como 0.

A tabela a seguir lista os caracteres de formato padrão para campos numéricos. Esses caracteres de formato não diferenciam maiúsculas de minúsculas, exceto para X, que exibe caracteres hexadecimal no caso especificado. Você pode acrescentar um número à maioria dos caracteres de formato para especificar quantos dígitos significativos ou casas decimais você deseja exibir.

Observação

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

Caractere de formato Descrição Exemplo
C ou c Exibe valores numéricos no formato de moeda. Você 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 Exibe valores inteiros no formato decimal. Você pode especificar o número de dígitos. (Embora o tipo seja chamado de "decimal", os números são formatados como inteiros.) Formato: {0:D}

1234 -> 1234

Formato: {0:D6}

1234 -> 001234
E ou e Exibe valores numéricos no formato científico (exponencial). Você 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 Exibe valores numéricos em formato fixo. Você 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 Exibe valores numéricos em formato geral (o mais compacto de notação de ponto fixo ou científico). Você 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 Exibe valores numéricos no formato de número (incluindo separadores de grupo e sinal negativo opcional). Você 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 Exibe valores numéricos no formato percentual. Você pode especificar o número de casas decimais. Formato: {0:P}

1 -> 100,00%

Formato: {0:P1}

.5 -> 50,0%
R ou r SingleExibe, Doubleou BigInteger valores no formato de ida e volta. Formato: {0:R}

123456789.12345678 -> 123456789.12345678
X ou x Exibe valores inteiros no formato hexadecimal. Você pode especificar o número de dígitos. Formato: {0:X}

255 -> FF

Formato: {0:x4}

255 -> 00ff

Para obter mais informações e exemplos que mostram a formatação para outros valores de cultura, consulte Cadeias de Caracteres de Formato Numérico Padrão. Você também pode criar cadeias de caracteres de formato numérico personalizado. Para obter mais informações, consulte Cadeias de caracteres de formato numérico personalizado.

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

Formatar caractere Descrição Exemplo
d Padrão de data abreviada. Formato: {0:d}

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

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

15/06/2009 13:45:30 -> segunda-feira, 15 de junho de 2009 13:45 PM
F Padrão de data/hora completa (hora completa). 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 (hora abreviada). Formato: {0:g}

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

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

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

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000
R ou r Padrão RFC1123 (para obter informações, consulte DateTimeFormatInfo.RFC1123Pattern). Formato: {0:R}

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT
s Padrão de data/hora classificável. Formato: {0:s}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30
t Padrão de hora abreviada. Formato: {0:t}

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

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

6/15/2009 1:45:30 PM -> 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 8:45:30 PM
Y ou y Padrão ano mês. Formato: {0:Y}

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

Para obter mais informações e exemplos que mostram a formatação para outros valores de cultura, consulte Cadeias de Caracteres de Formato de Data e Hora Padrão. Você também pode criar cadeias de caracteres de formato de data e hora personalizadas. Para obter mais informações, consulte Cadeias de caracteres de formato de data e hora personalizadas.

Aplica-se a

Confira também