Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad HyperLinkField.DataTextFormatString

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

public virtual string DataTextFormatString { get; set; }

Valor de propiedad

Type: System.String

Una cadena que especifica el formato en el que los títulos de hipervínculo en un HyperLinkField se muestran. El valor predeterminado es una cadena vacía (""), lo que indica que se aplica ningún formato especial a los títulos de hipervínculo.

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

System_CAPS_noteNota

La cadena de formato se aplica sólo cuando el DataTextField se establece la propiedad.

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

System_CAPS_noteNota

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 visualizado final.

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

System_CAPS_noteNota

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

Los dos puntos y los valores después de los dos puntos son opcionales. El carácter situado 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 enumera los formatos comunes.

Carácter de formato

Descripción

C

Muestra los valores numéricos en formato de moneda.

D

Muestra los valores numéricos en formato decimal.

E

Muestra los valores numéricos en formato científico (exponencial).

F

Muestra los valores numéricos en formato fijo.

G

Muestra los valores numéricos en formato general.

N

Muestra los valores numéricos en formato de número.

X

Muestra los valores numéricos en formato hexadecimal.

System_CAPS_noteNota

Los caracteres de formato no distinguen mayúsculas de minúsculas, excepto X, que muestra los caracteres hexadecimales en la grafía especificada.

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 muestran. 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 las cadenas de formato, consulte Aplicar formato a tipos en .NET Framework.

En el ejemplo de código siguiente se muestra cómo utilizar el DataTextFormatString propiedad para dar formato a los valores enlazados a los títulos de hipervínculo presentados en un HyperLinkField objeto. Los valores con 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>

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: