ListControl.DataTextFormatString Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Overridable Property DataTextFormatString As StringValor de propiedad
Cadena de formato para los datos enlazados al control. El valor predeterminado es Empty.
- Atributos
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.
