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

Use 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 daría 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 va a mostrar el valor. En la tabla siguiente se enumeran los formatos comunes.

Carácter de formato 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, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también