HyperLinkField.DataTextFormatString Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define a cadeia que especifica o formato em que as legendas do hipertexto num HyperLinkField objeto 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 de Propriedade

String

Uma cadeia que especifica o formato em que as legendas de hiperligação em um HyperLinkField são exibidas. O padrão é uma cadeia vazia (""), o que indica que não é aplicada qualquer formatação especial às legendas do hiperligação.

Exemplos

O exemplo de código seguinte demonstra como usar a DataTextFormatString propriedade para formatar os valores atribuídos às legendas do hiperlink exibidas num 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>

Observações

Use a DataTextFormatString propriedade para especificar um formato de visualização personalizado para as legendas apresentadas no HyperLinkField objeto. Se a DataTextFormatString propriedade não estiver definida, o valor do campo é exibido sem qualquer formatação especial.

Note

A string de formato é aplicada apenas quando a DataTextField propriedade está definida.

A cadeia de formato pode ser qualquer cadeia literal e normalmente inclui um marcador para o valor do campo. Por exemplo, na cadeia de formato "Item Value: {0}", o {0} marcador de posição é substituído pelo valor do campo quando é exibido no HyperLinkField objeto. O resto da cadeia de formatos é apresentado como texto literal.

Note

Se a cadeia de formato não incluir um marcador de posição, o valor do campo da fonte de dados não é incluído no texto final de visualização.

O marcador consiste em duas partes, separadas por dois pontos e envolvidas em colchetes, na forma {A:Bxx}. O valor antes dos dois-pontos (A no exemplo geral) especifica o índice do valor do campo numa lista de parâmetros baseada em zero.

Note

Este parâmetro faz parte da sintaxe de formatação. Como existe apenas um valor de campo em cada célula, este valor só pode ser definido para 0.

O dois-pontos e os valores após o dois-pontos são opcionais. O carácter após os dois-pontos (B no exemplo geral) especifica o formato em que o valor deve ser exibido. A tabela seguinte lista os formatos comuns.

Carácter de formato Description
C Apresenta valores numéricos em formato de moeda.
D Apresenta valores numéricos em formato decimal.
E Apresenta valores numéricos em formato científico (exponencial).
F Apresenta valores numéricos em formato fixo.
G Apresenta valores numéricos em formato geral.
N Apresenta valores numéricos em formato numérico.
X Apresenta valores numéricos em formato hexadecimal.

Note

Os caracteres de formato não são sensíveis a maiúsculas minúsculas, exceto , Xque mostra os caracteres hexadecimais no caso especificado.

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

Para mais informações sobre strings de formatação, consulte Tipos de Formatação.

Aplica-se a

Ver também