Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

BoundField.DataFormatString (Propiedad)

.NET Framework 4

Obtiene o establece la cadena que especifica el formato de presentación del valor del campo.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)
C#
C++
F#
VB
Copiar 
public virtual string DataFormatString { get; set; }

Valor de propiedad

Tipo: System.String
Una 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 un formato especial al valor del campo.

Utilice la propiedad DataFormatString para especificar un formato de presentación personalizado para los valores mostrados en el objeto BoundField. Si no se establece la propiedad DataFormatString, el valor del campo se muestra sin ningún formato especial.

Nota Nota

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

De manera predeterminada, la cadena de formato sólo se aplica al valor del campo cuando el control enlazado a datos que contiene el objeto BoundField está en modo de sólo lectura. Para aplicar la cadena de formato a los valores de campo durante el modo de edición, establezca la propiedad ApplyFormatInEditMode en true.

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

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

El formato se aplica usando el método Format. El número que sigue a la llave izquierda es la parte de la sintaxis usada por ese método e indica qué valor de una serie de valores debe usar el marcador de posición. Dado que hay solo uno valor de campo en cada celda, el número que sigue a la llave de cierre solo puede estar establecido en 0.

La tabla siguiente enumera los caracteres de formato estándar para campos numéricos. Estos caracteres de formato no se distingue entre mayúsculas y minúsculas, salvo en el caso de X, que muestra los caracteres hexadecimales en la grafía especificada. Puede anexar un número a la mayoría de los caracteres de formato para especificar cuántos dígitos significativos o posiciones decimal desea que se muestren.

Nota Nota

En la mayoría de los casos, el formato depende de la configuración de la 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 los 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 los valores enteros en formato decimal. Puede especificar el número de dígitos. (Aunque se hace referencia al tipo como "decimal", se da formato a los números como enteros.)

Formato: {0:D}

1234 -> 1234

Formato: {0:D6}

1234 -> 001234

E o e

Muestra los 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 los 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 (la notación de punto fijo o científica, la que sea más compacta). 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 los valores numéricos en formato de número (incluyendo los separadores de grupo y el 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 los 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 Single, Double o valores BigInteger en formato de ida y vuelta.

Formato: {0:R}

123456789,12345678 -> 123456789,12345678

X o x

Muestra los 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 con formato numérico estándar. También puede crear cadenas con formato de número personalizadas. Para obtener más información, vea Cadenas con formato numérico personalizado.

La tabla siguiente enumera los caracteres de formato para campos DateTime. La mayoría de estas características de formato producen un resultado diferente que depende de la configuración de la referencia cultural. Los ejemplos son para un valor DateTime de 6/15/2009 1:45:30 PM con una configuración de referencia cultural de en-US.

Carácter de formato

Descripción

Ejemplo

d

Modelo de fecha corta.

Formato: {0:d}

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

D

Modelo de fecha larga.

Formato: {0:D}

6/15/2009 1:45:30 PM ->Monday, June 15, 2009

f

Modelo de fecha y hora completa (hora corta).

Formato: {0:f}

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM

F

Modelo de fecha y hora completa (hora larga).

Formato: {0:F}

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM

g

Modelo de fecha y hora general (hora corta).

Formato: {0:g}

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

G

Modelo de fecha y hora general (hora larga).

Formato: {0:G}

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

M o m

Modelo de mes/día.

Formato: {0:M}

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

O o o

Modelo 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

modelo 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

Modelo de fecha y hora que se puede ordenar.

Formato: {0:s}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30

t

Modelo de hora corta.

Formato: {0:t}

6/15/2009 1:45:30 p.m. -> 1:45 p.m.

T

Modelo de hora larga.

Formato: {0:T}

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

u

Modelo 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

Modelo de fecha y hora completa universal.

Formato: {0:U}

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM

Y o y

Modelo de mes y año.

Formato: {0:Y}

6/15/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 con formato de fecha y hora estándar. También puede crear cadenas con formato de fecha y hora personalizadas. Para obtener más información, vea Cadenas de formato de fecha y hora personalizadas.

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

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

None
Copiar 

<%@ Page Language="C#" AutoEventWireup="true"  
    CodeFile="Default.aspx.cs" Inherits="_Default" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AWLTConnectionString %>" 
            SelectCommand="SELECT ProductID, Name, ProductNumber, 
                ListPrice, Weight, ModifiedDate FROM SalesLT.Product">
        </asp:SqlDataSource>
        <asp:GridView ID="GridView1" runat="server" 
            AutoGenerateColumns="False" 
            DataKeyNames="ProductID" DataSourceID="SqlDataSource1">
            <Columns>
                <asp:BoundField DataField="ProductID" 
                    HeaderText="ProductID" 
                    InsertVisible="False" ReadOnly="True" 
                    SortExpression="ProductID" 
                    DataFormatString="{0:D6}" />
                <asp:BoundField DataField="Name" 
                    HeaderText="Name" 
                    SortExpression="Name" 
                    DataFormatString="{0}" />
                <asp:BoundField DataField="ProductNumber" 
                    HeaderText="ProductNumber" 
                    SortExpression="ProductNumber" 
                    DataFormatString= "#{0}" />
                <asp:BoundField DataField="ListPrice" 
                    HeaderText="ListPrice" 
                    SortExpression="ListPrice"
                    DataFormatString="{0:C}" />
                <asp:BoundField DataField="Weight" 
                    HeaderText="Weight" 
                    SortExpression="Weight" 
                    DataFormatString="{0:F3}" />
                <asp:BoundField DataField="ModifiedDate" 
                    HeaderText="ModifiedDate" 
                    SortExpression="ModifiedDate" 
                    DataFormatString="{0:d}" />
            </Columns>
        </asp:GridView>
    </div>
    </form>
</body>
</html>

En el ejemplo siguiente se muestra una fila del resultado de aplicar este ejemplo.

ProductID

Name

ProductNumber

ListPrice

Weight

ModifiedDate

000680

HL Road Frame - Black, 58

#FR-R92B-58

$1,431.50

1016.040

3/11/2004

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Fecha

Historial

Motivo

Código de ejemplo corregido para coincidir con el ejemplo generado.

Comentarios de los clientes.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes