Compartir a través de

ListControl.DataTextFormatString Propiedad

  • Referencia

Definición

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

Obtiene o establece la cadena de formato que sirve para controlar cómo se muestran los datos enlazados al control de lista.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Valor de propiedad

String

Cadena de formato para los datos enlazados al control. El valor predeterminado es Empty.

Atributos
ThemeableAttribute

Comentarios

Utilice la DataTextFormatString propiedad para proporcionar un formato de presentación personalizado a los elementos de un control de lista.

La cadena de formato de datos consta de dos partes, separadas por dos puntos, con el formato { A : Bxx }. Por ejemplo, la cadena {0:F2} de formato da formato a la celda para mostrar un número de punto fijo con dos posiciones decimales.

Nota

Toda la cadena debe ir entre llaves para indicar que es una cadena de formato y no una cadena literal. Cualquier texto fuera de las llaves se muestra como texto literal.

El valor anterior a los dos puntos (A en el ejemplo general) especifica el índice de parámetros en una lista de parámetros de base cero.

Nota

Este valor solo se puede establecer en 0 porque solo hay un valor en cada celda.

El carácter después de los dos puntos (B en el ejemplo general) especifica el formato en el que se mostrará el valor. En la tabla siguiente se enumeran los formatos comunes.

Formato de carácter Descripción
C Muestra valores numéricos en formato de moneda.
D Muestra valores numéricos en formato decimal.
E Muestra valores numéricos en formato científico (exponencial).
F Muestra valores numéricos en formato fijo.
G Muestra valores numéricos en formato general.
N Muestra valores numéricos en formato numérico.
X Muestra valores numéricos en formato hexadecimal.

Nota

El carácter de formato no distingue mayúsculas de minúsculas, excepto para X, que muestra los caracteres hexadecimales en el caso especificado.

El valor después del carácter de formato (xx en el ejemplo general) especifica el número de dígitos significativos o posiciones decimales que se van a mostrar.

La tabla siguiente contiene ejemplos de cadenas de formato y los resultados. Se supone que la configuración de inglés estándar.

Valor numérico Cadena de formato Resultado
12345.6789 "{0:C}" $12,345.68
-12345.6789 "{0:C}" ($12,345.68)
12345 "{0:D}" 12345
12345 "{0:D8}" 00012345
12345.6789 "{0:E}" 1234568E+004
12345.6789 "{0:E10}" 1.2345678900E+004
12345.6789 "{0:F}" 12345.68
12345.6789 "{0:F0}" 12346
12345.6789 "{0:G}" 12345.6789
123456789 "{0:G7}" 1.234568E8
12345.6789 "{0:N}" 12,345.68
123456789 "{0:N4}" 123,456,789.0000
12345.6789 "Total: {0:C}" Total: 12345,68 USD

Para obtener más información sobre cómo dar formato a las cadenas, vea Tipos de formato.

El valor de esta propiedad se almacena en estado de vista.

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, consulte ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también