Compartir a través de

HyperLinkField.DataTextFormatString Propiedad

  • Referencia

Definición

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

Obtiene o establece la cadena que especifica el formato con el que se muestran los títulos de hipervínculo en un objeto HyperLinkField.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Valor de propiedad

String

Cadena que especifica el formato con el que se muestran los títulos de hipervínculo en un objeto HyperLinkField. El valor predeterminado es una cadena vacía (""), que indica que no se aplica un formato especial a los títulos de hipervínculo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la DataTextFormatString propiedad para dar formato a los valores enlazados a los títulos de hipervínculo que se muestran en un HyperLinkField objeto . Los valores tienen el formato de moneda.


<%@ Page language="C#" %>

<!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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- The UnitPrice field values are bound to the         -->
      <!-- captions of the hyperlinks in the HyperLinkField    -->
      <!-- field column, formatted as currency. The ProductID  -->
      <!-- field values are bound to the navigate URLs of the  -->
      <!-- hyperlinks. However, instead of being the actual    -->
      <!-- URL values, the product ID is passed to the linked  -->
      <!-- page as a parameter in the URL specified by the     -->
      <!-- DataNavigateUrlFormatString property.               -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="Order ID"/>
          <asp:boundfield datafield="ProductID" 
            headertext="Product ID"/>
          <asp:hyperlinkfield datatextfield="UnitPrice"
            datatextformatstring="{0:c}"
            datanavigateurlfields="ProductID"
            datanavigateurlformatstring="~\details.aspx?ProductID={0}"          
            headertext="Price"
            target="_blank" />
          <asp:boundfield datafield="Quantity" 
            headertext="Quantity"/>
                 
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!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>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- The UnitPrice field values are bound to the         -->
      <!-- captions of the hyperlinks in the HyperLinkField    -->
      <!-- field column, formatted as currency. The ProductID  -->
      <!-- field values are bound to the navigate URLs of the  -->
      <!-- hyperlinks. However, instead of being the actual    -->
      <!-- URL values, the product ID is passed to the linked  -->
      <!-- page as a parameter in the URL specified by the     -->
      <!-- DataNavigateUrlFormatString property.               -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="Order ID"/>
          <asp:boundfield datafield="ProductID" 
            headertext="Product ID"/>
          <asp:hyperlinkfield datatextfield="UnitPrice"
            datatextformatstring="{0:c}"
            datanavigateurlfields="ProductID"
            datanavigateurlformatstring="~\details.aspx?ProductID={0}"          
            headertext="Price"
            target="_blank" />
          <asp:boundfield datafield="Quantity" 
            headertext="Quantity"/>
                 
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Comentarios

Utilice la DataTextFormatString propiedad para especificar un formato de presentación personalizado para los títulos que se muestran en el HyperLinkField objeto . Si no se establece la DataTextFormatString propiedad, el valor del campo se muestra sin ningún formato especial.

Nota

La cadena de formato solo se aplica cuando se establece la DataTextField propiedad .

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 de formato "Item Value: {0}", el {0} marcador de posición se reemplaza por el valor del campo cuando se muestra en el HyperLinkField objeto . El resto de la cadena de formato se muestra como texto literal.

Nota

Si la cadena de formato no incluye un marcador de posición, el valor del campo del origen de datos no se incluye en el texto para mostrar final.

El marcador de posición consta de dos partes, separadas por dos puntos y ajustadas entre llaves, con el formato {A:Bxx}. El valor anterior a los dos puntos (A en el ejemplo general) especifica el índice del valor del campo en una lista de parámetros de base cero.

Nota

Este parámetro forma parte de la sintaxis de formato. Dado que solo hay un valor de campo en cada celda, este valor solo se puede establecer en 0.

Los dos puntos y los valores después de los dos puntos son opcionales. 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

Los caracteres de formato no distinguen 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. Por ejemplo, la cadena de formato "{0:F2}" muestra un número de punto fijo con dos posiciones decimales.

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

Se aplica a

Consulte también