BoundField.DataFormatString BoundField.DataFormatString BoundField.DataFormatString BoundField.DataFormatString Property

Definition

Obtiene o establece la cadena que especifica el formato de presentación del valor del campo. Gets or sets the string that specifies the display format for the value of the field.

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

Property Value

Cadena de formato que especifica el formato de presentación del valor del campo. A formatting string that specifies the display format for the value of the field. El valor predeterminado es una cadena vacía (""), lo que indica que no se aplica ningún formato especial al valor del campo. The default is an empty string (""), which indicates that no special formatting is applied to the field value.

Examples

Un proyecto de sitio Web de Visual Studio con código fuente está disponible como acompañamiento de este tema: descargar.A Visual Studio Web site project with source code is available to accompany this topic: Download.

El ejemplo siguiente muestra cómo usar el DataFormatString propiedad para especificar un formato de presentación personalizado para los valores de un campo.The following example shows how to use the DataFormatString property to specify a custom display format for the values of a field.

El ejemplo siguiente muestra una fila de la salida generada por este ejemplo.The following example shows one row of the output that is produced by this example.

ProductIDProductID nombreName ProductNumberProductNumber ListPriceListPrice EspesorWeight ModifiedDateModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

Remarks

Use la DataFormatString propiedad para especificar un formato de presentación personalizado para los valores que se muestran en la BoundField objeto.Use the DataFormatString property to specify a custom display format for the values that are displayed in the BoundField object. Si el DataFormatString no está establecida la propiedad, el valor del campo se muestra sin ningún formato especial.If the DataFormatString property is not set, the field's value is displayed without any special formatting.

Nota

En versiones de ASP.NET anteriores a la 3.5, debe establecer el HtmlEncode propiedad false con el fin de dar formato a los campos que son no tipos de datos string.In versions of ASP.NET earlier than 3.5, you must set the HtmlEncode property to false in order to format fields that are not string data types. En caso contrario, el valor del campo se convierte en una cadena por el método de conversión predeterminado antes de la cadena de formato que se almacena en el DataFormatString se aplica la propiedad.Otherwise, the field value is converted to a string by the default conversion method before the format string that is stored in the DataFormatString property is applied.

De forma predeterminada, la cadena de formato se aplica al valor del campo solo cuando el control enlazado a datos que contiene el BoundField objeto está en modo de solo lectura.By default, the formatting string is applied to the field value only when the data-bound control that contains the BoundField object is in read-only mode. Para aplicar la cadena de formato a valores de campo en el modo de edición, establezca el ApplyFormatInEditMode propiedad true.To apply the formatting string to field values while in edit mode, set the ApplyFormatInEditMode property to true.

La cadena de formato puede ser cualquier cadena de literal y normalmente incluye un marcador de posición para el valor del campo.The formatting string can be any literal string and usually includes a placeholder for the field's value. Por ejemplo, en la cadena de formato Item Value: {0}, el valor del campo se sustituye por el {0} marcador de posición cuando la cadena se muestra en el BoundField objeto.For example, in the formatting string Item Value: {0}, the field's value is substituted for the {0} placeholder when the string is displayed in the BoundField object. El resto de la cadena de formato se muestra como texto literal.The rest of the formatting string is displayed as literal text.

Si la cadena de formato no incluye un marcador de posición, solo la propia cadena de formato se incluye en el texto visualizado final (no se incluye el valor del campo del origen de datos).If the formatting string does not include a placeholder, only the formatting string itself is included in the final display text (the field's value from the data source is not included). Si el marcador de posición es 0 (cero) encerrado entre llaves, tal como se muestra en el ejemplo anterior, el valor del campo se convierte en una cadena por el método predeterminado.If the placeholder is a 0 (zero) enclosed in curly braces as shown in the preceding example, the field value is converted to a string by the default method. Puede anexar el cero en una cadena que especifica cómo se debe dar formato el valor del campo.You can append to the zero a string that specifies how the field value should be formatted. Por ejemplo, el marcador de posición {0:C} para un campo numérico especifica que el valor del campo debe convertirse en un formato de moneda.For example, the placeholder {0:C} for a numeric field specifies that value of the field should be converted to a currency format.

Se aplica formato mediante el uso de la Format método.Formatting is applied by using the Format method. El número que sigue a la llave de apertura es parte de la sintaxis usada por ese método e indica que uno de una serie de valores que debe utilizar el marcador de posición.The number that follows the left curly brace is part of the syntax used by that method and indicates which one of a series of values the placeholder should use. Dado que hay solo un valor de campo en cada celda, el número que sigue a la llave de apertura solo puede establecerse en 0.Because there is only one field value in each cell, the number that follows the left curly brace can only be set to 0.

En la tabla siguiente se enumera los caracteres de formato estándar para los campos numéricos.The following table lists the standard format characters for numeric fields. Estos caracteres de formato no distinguen mayúsculas de minúsculas, excepto para X, que muestra los caracteres hexadecimales en el caso de que se ha especificado.These format characters are not case-sensitive, except for X, which displays hexadecimal characters in the case that is specified. Puede anexar un número para la mayoría de los caracteres de formato para especificar cuántos dígitos significativos o posiciones decimales que se va a mostrar.You can append a number to most format characters in order to specify how many significant digits or decimal places you want to display.

Nota

En la mayoría de los casos, formato depende de configuración de la referencia cultural del servidor.In most cases, formatting depends on the server's culture setting. Los ejemplos son para una configuración de referencia cultural en-US.The examples are for a culture setting of en-US.

Carácter de formatoFormat character DescripciónDescription EjemploExample
C o cC or c Muestra los valores numéricos en formato de moneda.Displays numeric values in currency format. Puede especificar el número de posiciones decimales.You can specify the number of decimal places. Formato: {0:C}Format: {0:C}

123.456 -> $123.46123.456 -> $123.46

Formato: {0:C3}Format: {0:C3}

123.456 -> $123.456123.456 -> $123.456
D o dD or d Muestra los valores enteros en formato decimal.Displays integer values in decimal format. Puede especificar el número de dígitos.You can specify the number of digits. (Aunque el tipo se conoce como "decimal", los números de formato de números enteros.)(Although the type is referred to as "decimal", the numbers are formatted as integers.) Formato: {0:D}Format: {0:D}

1234 -> 12341234 -> 1234

Formato: {0:D6}Format: {0:D6}

1234 -> 0012341234 -> 001234
E o eE or e Muestra los valores numéricos en formato científico (exponencial).Displays numeric values in scientific (exponential) format. Puede especificar el número de posiciones decimales.You can specify the number of decimal places. Formato: {0:E}Format: {0:E}

1052.0329112756 -> 1.052033E + 003.1052.0329112756 -> 1.052033E+003

Formato: {0:E2}Format: {0:E2}

->-1052.0329112756-1.05e + 003.-1052.0329112756 -> -1.05e+003
F o fF or f Muestra los valores numéricos en formato fijo.Displays numeric values in fixed format. Puede especificar el número de posiciones decimales.You can specify the number of decimal places. Formato: {0:F}Format: {0:F}

1234.567 -> 1234.571234.567 -> 1234.57

Formato: {0:F3}Format: {0:F3}

1234.567 -> 1234.5671234.567 -> 1234.567
G o gG or g Muestra los valores numéricos en formato general (más compacto de notación de punto fijo o científica).Displays numeric values in general format (the most compact of either fixed-point or scientific notation). Puede especificar el número de dígitos significativos.You can specify the number of significant digits. Formato: {0:G}Format: {0:G}

-123.456 -> -123.456-123.456 -> -123.456

Formato: {0:G2}Format: {0:G2}

-123.456 -> -120-123.456 -> -120
N o nN or n Muestra los valores numéricos en formato de número (incluidos los separadores de grupos y el signo negativo opcional).Displays numeric values in number format (including group separators and optional negative sign). Puede especificar el número de posiciones decimales.You can specify the number of decimal places. Formato: {0:N}Format: {0:N}

1234.567 -> 1,234.571234.567 -> 1,234.57

Formato: {0:N4}Format: {0:N4}

1234.567 -> 1,234.56701234.567 -> 1,234.5670
P o pP or p Muestra los valores numéricos en formato de porcentaje.Displays numeric values in percent format. Puede especificar el número de posiciones decimales.You can specify the number of decimal places. Formato: {0:P}Format: {0:P}

1 -> 100.00%1 -> 100.00%

Formato: {0:P1}Format: {0:P1}

.5 -> 50.0%.5 -> 50.0%
R o rR or r Muestra Single, Double, o BigInteger valores en formato de ida y vuelta.Displays Single, Double, or BigInteger values in round-trip format. Formato: {0:R}Format: {0:R}

123456789.12345678 -> 123456789.12345678123456789.12345678 -> 123456789.12345678
X o xX or x Muestra los valores enteros en formato hexadecimal.Displays integer values in hexadecimal format. Puede especificar el número de dígitos.You can specify the number of digits. Formato: {0:X}Format: {0:X}

255 -> FF255 -> FF

Formato: {0:x4}Format: {0:x4}

255 -> 00ff255 -> 00ff

Para obtener más información y ejemplos que muestran el formato de otros valores de referencia cultural, consulte cadenas de formato numérico estándar.For more information and for examples that show formatting for other culture values, see Standard Numeric Format Strings. También puede crear cadenas de formato numérico personalizado.You can also create custom numeric format strings. Para obtener más información, consulte Cadenas con formato numérico personalizado.For more information, see Custom Numeric Format Strings.

En la tabla siguiente se enumera los caracteres de formato para DateTime campos.The following table lists format characters for DateTime fields. La mayoría de estas especificaciones de formato como resultado una salida diferente según la configuración de referencia cultural.Most of these formatting specifications result in a different output depending on culture settings. Los ejemplos son para un DateTime valor de 15/6/2009 1:45:30 PM con una configuración de referencia cultural en-US.The examples are for a DateTime value of 6/15/2009 1:45:30 PM with a culture setting of en-US.

Carácter de formatoFormat character DescripciónDescription EjemploExample
d Patrón de fecha corta.Short date pattern. Formato: {0:d}Format: {0:d}

15/6/2009 1:45:30 PM -> 15/6/20096/15/2009 1:45:30 PM -> 6/15/2009
D Patrón de fecha larga.Long date pattern. Formato: {0:D}Format: {0:D}

15/6/2009 1:45:30 PM -> el lunes, 15 de junio de 20096/15/2009 1:45:30 PM ->Monday, June 15, 2009
f Patrón de fecha y hora completa (hora corta).Full date/time pattern (short time). Formato: {0:f}Format: {0:f}

15/6/2009 1:45:30 PM -> el lunes, 15 de junio de 2009 1:45 p. M.6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM
F Patrón de fecha y hora completa (hora larga).Full date/time pattern (long time). Formato: {0:F}Format: {0:F}

15/6/2009 1:45:30 PM -> el lunes, 15 de junio de 2009 1:45:30 PM6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM
g Patrón de fecha y hora general (hora corta).General date/time pattern (short time). Formato: {0:g}Format: {0:g}

15/6/2009 1:45:30 PM -> 15/6/2009 1:45 P. M.6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM
G Patrón de fecha y hora general (hora larga).General date/time pattern (long time). Formato: {0:G}Format: {0:G}

15/6/2009 1:45:30 PM -> 15/6/2009 1:45:30 PM6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM
M o mM or m Patrón de mes/día.Month/day pattern. Formato: {0:M}Format: {0:M}

15/6/2009 1:45:30 PM -> 15 de junio6/15/2009 1:45:30 PM -> June 15
O o oO or o Patrón de fecha y hora de ida y vuelta.Round-trip date/time pattern. Formato: {0:o}Format: {0:o}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.09000006/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000
R o rR or r Patrón RFC1123 (para obtener información, consulte DateTimeFormatInfo.RFC1123Pattern).RFC1123 pattern (for information, see DateTimeFormatInfo.RFC1123Pattern). Formato: {0:R}Format: {0:R}

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT
s Patrón de fecha y hora que se puede ordenar.Sortable date/time pattern. Formato: {0:s}Format: {0:s}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:306/15/2009 1:45:30 PM -> 2009-06-15T13:45:30
t Patrón de hora corta.Short time pattern. Formato: {0:t}Format: {0:t}

15/6/2009 1:45:30 PM -> 1:45 P. M.6/15/2009 1:45:30 PM -> 1:45 PM
T Patrón de hora larga.Long time pattern. Formato: {0:T}Format: {0:T}

15/6/2009 1:45:30 PM -> 1:45:30 PM6/15/2009 1:45:30 PM -> 1:45:30 PM
u Patrón de fecha y hora universal que se puede ordenar.Universal sortable date/time pattern. Formato: {0:u}Format: {0:u}

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z
U Patrón de fecha y hora completa universal.Universal full date/time pattern. Formato: {0:U}Format: {0:U}

15/6/2009 1:45:30 PM -> el lunes, 15 de junio de 2009 8:45:30 PM6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM
Y o yY or y Patrón de mes y año.Year month pattern. Formato: {0:Y}Format: {0:Y}

15/6/2009 1:45:30 PM -> de junio de 20096/15/2009 1:45:30 PM -> June, 2009

Para obtener más información y ejemplos que muestran el formato de otros valores de referencia cultural, consulte Standard Date and Time Format Strings.For more information and for examples that show formatting for other culture values, see Standard Date and Time Format Strings. También puede crear cadenas de formato de hora y fecha personalizada.You can also create custom date and time format strings. Para obtener más información, consulte Custom Date and Time Format Strings.For more information, see Custom Date and Time Format Strings.

Applies to

See Also