HyperLinkField.DataNavigateUrlFormatString Eigenschaft

  • Referenz

Definition

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

Ruft die Zeichenfolge ab, die das Format angibt, in dem die URLs für die Links in einem HyperLinkField-Objekt gerendert werden, oder legt diese Zeichenfolge fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die das Format angibt, in dem die URLs für die Links in einem HyperLinkField gerendert werden. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass keine besondere Formatierung auf die URL-Werte angewendet wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DataNavigateUrlFormatString -Eigenschaft verwendet wird, um ein benutzerdefiniertes Format anzugeben, das auf die Navigations-URLs der in einem HyperLinkField -Objekt angezeigten Links angewendet werden soll. Der Wert des von der DataTextField -Eigenschaft angegebenen Felds wird als Abfragezeichenfolge an eine Webseite übergeben, die in der Formatzeichenfolge angegeben ist.


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

Hinweise

Verwenden Sie die DataNavigateUrlFormatString -Eigenschaft, um ein benutzerdefiniertes Format für die URLs der Hyperlinks in einem HyperLinkField -Objekt anzugeben. Wenn die DataNavigateUrlFormatString Eigenschaft nicht festgelegt ist, erhalten die URLs der Hyperlinks keine spezielle Formatierung.

Hinweis

Die Formatzeichenfolge wird nur angewendet, wenn die DataNavigateUrlFields -Eigenschaft festgelegt ist.

Die Formatzeichenfolge kann eine beliebige Literalzeichenfolge sein und enthält in der Regel einen Platzhalter für den Wert des Felds. Beispielsweise wird in der Formatzeichenfolge "Item Value: " {0}der {0} Platzhalter durch den Wert des Felds im HyperLinkField -Objekt ersetzt. Der Rest der Formatzeichenfolge wird als Literaltext angezeigt.

Hinweis

Wenn die Formatzeichenfolge keinen Platzhalter enthält, ist der Wert des Felds aus der Datenquelle nicht im endgültigen Anzeigetext enthalten.

Der Platzhalter besteht aus zwei Teilen, die durch einen Doppelpunkt getrennt und in geschweifte Klammern im Format {A:Bxx} umschlossen sind. Der Wert vor dem Doppelpunkt (A im allgemeinen Beispiel) gibt den Index des Feldwerts in einer nullbasierten Liste von Parametern an.

Hinweis

Dieser Parameter ist Teil der Formatierungssyntax. Da in jeder Zelle nur ein Feldwert vorhanden ist, kann dieser Wert nur auf 0 festgelegt werden.

Der Doppelpunkt und die Werte nach dem Doppelpunkt sind optional. Das Zeichen nach dem Doppelpunkt (B im allgemeinen Beispiel) gibt das Format an, in dem der Wert angezeigt werden soll. In der folgenden Tabelle sind die gängigen Formate aufgeführt.

Formatieren von Zeichen BESCHREIBUNG
C Zeigt numerische Werte im Währungsformat an.
D Zeigt numerische Werte im Dezimalformat an.
E Zeigt numerische Werte im wissenschaftlichen (exponentiellen) Format an.
F Zeigt numerische Werte im festen Format an.
G Zeigt numerische Werte im allgemeinen Format an.
N Zeigt numerische Werte im Zahlenformat an.
X Zeigt numerische Werte im Hexadezimalformat an.

Hinweis

Bei den Formatzeichen wird die Groß-/Kleinschreibung nicht beachtet, mit Ausnahme von X, das die Hexadezimalzeichen in der angegebenen Groß-/Kleinschreibung anzeigt.

Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl der anzuzeigenden signifikanten Ziffern oder Dezimalstellen an. Die Formatzeichenfolge "{0:F2}" zeigt beispielsweise eine Festzahl mit zwei Dezimalstellen an.

Weitere Informationen zum Formatieren von Zeichenfolgen finden Sie unter Formatierungstypen.

Gilt für:

Weitere Informationen