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

Definición

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

Valor de propiedad

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 un formato especial al valor del campo.The default is an empty string (""), which indicates that no special formatting is applied to the field value.

Ejemplos

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

En el ejemplo siguiente se muestra cómo utilizar DataFormatString la 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.

En el ejemplo siguiente se 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

Comentarios

Utilice la DataFormatString propiedad para especificar un formato de presentación personalizado para los valores que se muestran en BoundField el objeto.Use the DataFormatString property to specify a custom display format for the values that are displayed in the BoundField object. Si no DataFormatString se establece 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 las versiones de ASP.net anteriores a 3,5, debe establecer la HtmlEncode false propiedad en para dar formato a los campos que no son tipos de datos de cadena.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. De lo contrario, el método de conversión predeterminado convierte el valor del campo en una cadena antes de que se aplique la cadena DataFormatString de formato que se almacena en 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 solo se aplica al valor de campo cuando el control enlazado a datos BoundField que contiene el 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 los valores de campo en modo de edición ApplyFormatInEditMode , establezca truela propiedad en.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 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 Item Value: {0}de formato, el valor del campo se sustituye por el {0} marcador de posición cuando se muestra la cadena 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 se incluye la propia cadena de formato en el texto de presentación 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 un 0 (cero) entre llaves, tal como se muestra en el ejemplo anterior, el valor del campo se convierte en una cadena mediante 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 al cero una cadena que especifica cómo se debe dar formato al valor del campo.You can append to the zero a string that specifies how the field value should be formatted. Por ejemplo, el marcador {0:C} de posición de un campo numérico especifica que el valor del campo debe convertirse a 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.

El formato se aplica mediante el Format método.Formatting is applied by using the Format method. El número que sigue a la llave izquierda forma parte de la sintaxis que usa ese método e indica cuál de las series de valores 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 solo hay un valor de campo en cada celda, el número que sigue a la llave de apertura solo se puede establecer 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 enumeran 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 X, que muestra los caracteres hexadecimales en el caso de que se especifique.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 a la mayoría de los caracteres de formato para especificar cuántos dígitos significativos o posiciones decimales desea que se muestren.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, el formato depende de la configuración de referencia cultural del servidor.In most cases, formatting depends on the server's culture setting. Los ejemplos son para una configuración de referencia en-UScultural de.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 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 se formatean como 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+0031052.0329112756 -> 1.052033E+003

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

-1052,0329112756->-1.05 e + 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 (la notación de punto fijo o científica más compacta).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 Singlelos Doublevalores, BigInteger o 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 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, vea cadenas con 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 enumeran DateTime los caracteres de formato de los campos.The following table lists format characters for DateTime fields. La mayoría de estas especificaciones de formato dan como resultado una salida diferente en función de la configuración de la referencia cultural.Most of these formatting specifications result in a different output depending on culture settings. Los ejemplos son para un DateTime valor de 6/15/2009 1:45:30 PM con un valor de referencia en-UScultural de.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}

6/15/2009 1:45:30 PM-> 6/15/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}

6/15/2009 1:45:30 PM-> 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}

6/15/2009 1:45:30 PM-> lunes, 15 de junio de 2009 1:45 PM6/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}

6/15/2009 1:45:30 PM-> 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}

6/15/2009 1:45:30 PM-> 6/15/2009 1:45 PM6/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}

6/15/2009 1:45:30 PM-> 6/15/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}

6/15/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, DateTimeFormatInfo.RFC1123Patternvea).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}

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

6/15/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}

6/15/2009 1:45:30 PM-> 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}

6/15/2009 1:45:30 PM-> 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, vea cadenas con formato de fecha y hora estándar.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 con formato de fecha y hora personalizado.You can also create custom date and time format strings. Para obtener más información, vea cadenas con formato de fecha y hora personalizado.For more information, see Custom Date and Time Format Strings.

Se aplica a

Consulte también: