HyperLinkField.DataNavigateUrlFormatString 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 os URLs dos hiperlinks num HyperLinkField objeto são renderizados.

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

Valor de Propriedade

String

Uma cadeia que especifica o formato em que os URLs dos hiperlinks em um HyperLinkField são renderizados. O padrão é uma string vazia (""), o que indica que não é aplicada qualquer formatação especial aos valores da URL.

Exemplos

O exemplo de código seguinte demonstra como usar a DataNavigateUrlFormatString propriedade para especificar um formato personalizado a aplicar às URLs de navegação dos hiperlinks exibidos num HyperLinkField objeto. O valor do campo especificado pela DataTextField propriedade é passado como uma cadeia de consulta para uma página Web especificada na cadeia de formato.


<%@ 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 DataNavigateUrlFormatString propriedade para especificar um formato personalizado para as URLs dos hiperlinks num HyperLinkField objeto. Se a DataNavigateUrlFormatString propriedade não estiver definida, os URLs dos hiperlinks não recebem qualquer formatação especial.

Note

A string de formato é aplicada apenas quando a DataNavigateUrlFields 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 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