BoundField.DataFormatString Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la cadena que especifica el formato de presentación del valor del 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 propiedad

String

Cadena de formato que especifica el formato de presentación del valor del campo. El valor predeterminado es una cadena vacía (""), lo que indica que no se aplica ningún formato especial al valor del campo.

Ejemplos

Hay disponible un proyecto de sitio web Visual Studio con código fuente para acompañar este tema: Descargar.

En el ejemplo siguiente se muestra cómo usar la DataFormatString propiedad para especificar un formato de presentación personalizado para los valores de un campo.

En el ejemplo siguiente se muestra una fila de la salida generada por este ejemplo.

ProductID Nombre ProductNumber ListPrice Peso ModifiedDate
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 el BoundField objeto . Si no se establece la DataFormatString propiedad, el valor del campo se muestra sin ningún formato especial.

Nota

En versiones de ASP.NET anteriores a la 3.5, debe establecer la HtmlEncode propiedad false en para dar formato a los campos que no son tipos de datos de cadena. De lo contrario, el valor del campo se convierte en una cadena mediante el método de conversión predeterminado antes de aplicar la cadena de formato almacenada en la DataFormatString propiedad .

De forma predeterminada, la cadena de formato se aplica al valor de campo solo cuando el control enlazado a datos que contiene el BoundField objeto está en modo de solo lectura. Para aplicar la cadena de formato a los valores de campo mientras se encuentra en modo de edición, establezca la ApplyFormatInEditMode propiedad trueen .

La cadena de formato puede ser cualquier cadena literal y normalmente incluye un marcador de posición para el valor del campo. Por ejemplo, en la cadena Item Value: {0}de formato , el valor del campo se sustituye por el {0} marcador de posición cuando la cadena se muestra en el BoundField objeto . El resto de la cadena de formato se muestra como texto literal.

Si la cadena de formato no incluye un marcador de posición, solo se incluye la propia cadena de formato en el texto para mostrar final (no se incluye el valor del campo del origen de datos). Si el marcador de posición es 0 (cero) entre llaves, como se muestra en el ejemplo anterior, el valor del campo se convierte en una cadena mediante el método predeterminado. Puede anexar a cero una cadena que especifique cómo se debe dar formato al valor del campo. Por ejemplo, el marcador {0:C} de posición de un campo numérico especifica que el valor del campo se debe convertir en un formato de moneda.

El formato se aplica mediante el Format método . El número que sigue a la llave izquierda forma parte de la sintaxis utilizada por ese método e indica cuál de una serie de valores debe usar el marcador de posición. Dado que solo hay un valor de campo en cada celda, el número que sigue a la llave izquierda solo se puede establecer en 0.

En la tabla siguiente se enumeran los caracteres de formato estándar para los campos numéricos. Estos caracteres de formato no distinguen mayúsculas de minúsculas, excepto para X, que muestra caracteres hexadecimales en el caso especificado. 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 mostrar.

Nota

En la mayoría de los casos, el formato depende de la configuración de referencia cultural del servidor. Los ejemplos son para una configuración de referencia cultural de en-US.

Carácter de formato Descripción Ejemplo
C o c Muestra valores numéricos en formato de moneda. Puede especificar el número de posiciones decimales. Formato: {0:C}

123.456 -> $123.46

Formato: {0:C3}

123.456 -> $123.456
D o d Muestra valores enteros en formato decimal. Puede especificar el número de dígitos. (Aunque el tipo se conoce como "decimal", los números tienen el formato entero). Formato: {0:D}

1234 -> 1234

Formato: {0:D6}

1234 -> 001234
E o e Muestra valores numéricos en formato científico (exponencial). Puede especificar el número de posiciones decimales. Formato: {0:E}

1052.0329112756 -> 1.052033E+003

Formato: {0:E2}

-1052.0329112756 -> -1.05e+003
F o f Muestra valores numéricos en formato fijo. Puede especificar el número de posiciones decimales. Formato: {0:F}

1234.567 -> 1234.57

Formato: {0:F3}

1234.567 -> 1234.567
G o g Muestra valores numéricos en formato general (el más compacto de punto fijo o notación científica). Puede especificar el número de dígitos significativos. Formato: {0:G}

-123.456 -> -123.456

Formato: {0:G2}

-123.456 -> -120
N o n Muestra valores numéricos en formato numérico (incluidos separadores de grupo y signo negativo opcional). Puede especificar el número de posiciones decimales. Formato: {0:N}

1234.567 -> 1,234.57

Formato: {0:N4}

1234.567 -> 1,234.5670
P o p Muestra valores numéricos en formato de porcentaje. Puede especificar el número de posiciones decimales. Formato: {0:P}

1 -> 100.00%

Formato: {0:P1}

.5 -> 50.0%
R o r Muestra Singlelos valores , Doubleo BigInteger en formato de ida y vuelta. Formato: {0:R}

123456789.12345678 -> 123456789.12345678
X o x Muestra valores enteros en formato hexadecimal. Puede especificar el número de dígitos. Formato: {0:X}

255 -> FF

Formato: {0:x4}

255 -> 00ff

Para obtener más información y ejemplos que muestran el formato de otros valores de referencia cultural, vea Cadenas de formato numérico estándar. También puede crear cadenas de formato numérico personalizado. Para obtener más información, consulte Cadenas con formato numérico personalizado.

En la tabla siguiente se enumeran los caracteres de formato de los DateTime campos. La mayoría de estas especificaciones de formato dan lugar a una salida diferente en función de la configuración de referencia cultural. Los ejemplos son para un DateTime valor de 15/6/2009 1:45:30 PM con un valor de referencia cultural de en-US.

Formato de carácter Descripción Ejemplo
d Patrón de fecha corta. Formato: {0:d}

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

15/6/2009 1:45:30 PM ->lunes, 15 de junio de 2009
f Patrón de fecha y hora completa (hora corta). Formato: {0:f}

15/6/2009 1:45:30 PM -> lunes, 15 de junio de 2009 1:45 p. m.
F Patrón de fecha y hora completa (hora larga). Formato: {0:F}

15/6/2009 1:45:30 PM -> lunes, 15 de junio de 2009 1:45:30 p. m.
g Patrón de fecha y hora general (hora corta). Formato: {0:g}

15/6/2009 1:45:30 PM -> 15/6/2009 1:45 PM
G Patrón de fecha y hora general (hora larga). Formato: {0:G}

15/6/2009 1:45:30 PM -> 15/15/2009 1:45:30 PM
M o m Patrón de mes/día. Formato: {0:M}

15/6/2009 1:45:30 PM -> 15 de junio
O o o Patrón de fecha y hora de ida y vuelta. Formato: {0:o}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000
R o r Patrón RFC1123 (para obtener información, vea DateTimeFormatInfo.RFC1123Pattern). Formato: {0:R}

6/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. Formato: {0:s}

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

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

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

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

15/6/2009 1:45:30 PM -> lunes, 15 de junio de 2009 8:45:30 p. m.
Y o y Patrón de mes y año. Formato: {0:Y}

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

Para obtener más información y ejemplos que muestran el formato de otros valores de referencia cultural, vea Cadenas de formato de fecha y hora estándar. También puede crear cadenas de formato de fecha y hora personalizadas. Para obtener más información, vea Cadenas de formato de fecha y hora personalizados.

Se aplica a

Consulte también