HyperLinkField.DataTextFormatString Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a cadeia de caracteres que especifica o formato no qual as legendas de hiperlink em um objeto HyperLinkField são exibidas.

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 da propriedade

String

Uma cadeia de caracteres que especifica o formato no qual as legendas de hiperlink em um HyperLinkField são exibidas. O padrão é uma cadeia de caracteres vazia (""), o que indica que nenhuma formatação especial é aplicada às legendas de hiperlink.

Exemplos

O exemplo de código a seguir demonstra como usar a DataTextFormatString propriedade para formatar os valores associados às legendas de hiperlink exibidas em um HyperLinkField objeto. Os valores são formatados como moeda.


<%@ 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>

Comentários

Use a DataTextFormatString propriedade para especificar um formato de exibição personalizado para as legendas exibidas no HyperLinkField objeto. Se a DataTextFormatString propriedade não estiver definida, o valor do campo será exibido sem nenhuma formatação especial.

Observação

A cadeia de caracteres de formato é aplicada somente quando a DataTextField propriedade é definida.

A cadeia de caracteres de formato pode ser qualquer cadeia de caracteres literal e geralmente inclui um espaço reservado para o valor do campo. Por exemplo, na cadeia de caracteres de formato "Valor do Item: {0}", o {0} espaço reservado é substituído pelo valor do campo quando ele é exibido no HyperLinkField objeto. O restante da cadeia de caracteres de formato é exibido como texto literal.

Observação

Se a cadeia de caracteres de formato não incluir um espaço reservado, o valor do campo da fonte de dados não será incluído no texto de exibição final.

O espaço reservado consiste em duas partes, separadas por dois-pontos e encapsuladas em chaves, na forma {A:Bxx}. O valor antes dos dois-pontos (A no exemplo geral) especifica o índice do valor do campo em uma lista de parâmetros baseados em zero.

Observação

Esse parâmetro faz parte da sintaxe de formatação. Como há apenas um valor de campo em cada célula, esse valor só pode ser definido como 0.

Os dois-pontos e os valores após os dois-pontos são opcionais. O caractere após os dois-pontos (B no exemplo geral) especifica o formato no qual exibir o valor. A tabela a seguir lista os formatos comuns.

Caractere de formato Descrição
C Exibe valores numéricos no formato de moeda.
D Exibe valores numéricos no formato decimal.
E Exibe valores numéricos no formato científico (exponencial).
F Exibe valores numéricos em formato fixo.
G Exibe valores numéricos em formato geral.
N Exibe valores numéricos no formato numérico.
X Exibe valores numéricos no formato hexadecimal.

Observação

Os caracteres de formato não diferenciam maiúsculas de minúsculas, exceto para X, que exibe os caracteres hexadecimal no caso especificado.

O valor após o caractere de formato (xx no exemplo geral) especifica o número de dígitos significativos ou casas decimais a serem exibidas. Por exemplo, a cadeia de caracteres de formato "{0:F2}" exibe um número de ponto fixo com duas casas decimais.

Para mais informações sobre cadeias de caracteres de formatação, consulte Tipos de formatação.

Aplica-se a

Confira também