HyperLinkField.DataNavigateUrlFormatString Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger strängen som anger i vilket format URL:erna för hyperlänkarna i ett HyperLinkField objekt återges.

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

Egenskapsvärde

String

En sträng som anger i vilket format URL:erna för hyperlänkarna i en HyperLinkField återges. Standardvärdet är en tom sträng (""), som anger att ingen särskild formatering tillämpas på URL-värdena.

Exempel

Följande kodexempel visar hur du använder DataNavigateUrlFormatString egenskapen för att ange ett anpassat format som ska tillämpas på navigerings-URL:erna för hyperlänkarna som visas i ett HyperLinkField objekt. Värdet för det fält som anges av DataTextField egenskapen skickas som en frågesträng till en webbsida som anges i formatsträngen.


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

Kommentarer

Använd egenskapen DataNavigateUrlFormatString för att ange ett anpassat format för URL:erna för hyperlänkarna i ett HyperLinkField objekt. Om egenskapen DataNavigateUrlFormatString inte har angetts får hyperlänkarnas URL:er ingen särskild formatering.

Note

Formatsträngen tillämpas endast när egenskapen DataNavigateUrlFields har angetts.

Formatsträngen kan vara valfri literalsträng och innehåller vanligtvis en platshållare för fältets värde. I formatsträngen "Item Value: {0}" {0} ersätts platshållaren till exempel med fältets värde i HyperLinkField objektet. Resten av formatsträngen visas som literaltext.

Note

Om formatsträngen inte innehåller någon platshållare inkluderas inte fältets värde från datakällan i den slutliga visningstexten.

Platshållaren består av två delar, avgränsade med ett kolon och inslagna i klammerparenteser, i formatet {A:Bxx}. Värdet före kolonet (A i det allmänna exemplet) anger fältvärdets index i en nollbaserad lista med parametrar.

Note

Den här parametern är en del av formateringssyntaxen. Eftersom det bara finns ett fältvärde i varje cell kan det här värdet bara anges till 0.

Kolonet och värdena efter kolonet är valfria. Tecknet efter kolonet (B i det allmänna exemplet) anger i vilket format värdet ska visas. I följande tabell visas de vanliga formaten.

Formattecken Description
C Visar numeriska värden i valutaformat.
D Visar numeriska värden i decimalformat.
E Visar numeriska värden i vetenskapligt (exponentiellt) format.
F Visar numeriska värden i fast format.
G Visar numeriska värden i allmänt format.
N Visar numeriska värden i talformat.
X Visar numeriska värden i hexadecimalt format.

Note

Formattecken är inte skiftlägeskänsliga, förutom X, som visar hexadecimala tecken i det angivna fallet.

Värdet efter formattecknet (xx i det allmänna exemplet) anger antalet signifikanta siffror eller decimaler som ska visas. Formatsträngen "{0:F2}" visar till exempel ett fast punktnummer med två decimaler.

Mer information om formateringssträngar finns i Formateringstyper.

Gäller för

Se även