Aracılığıyla paylaş

HyperLinkField.DataNavigateUrlFormatString Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Bir HyperLinkField nesnedeki köprüler için URL'lerin işlendiği biçimi belirten dizeyi alır veya ayarlar.

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

Özellik Değeri

String

içindeki köprülerin URL'lerinin işlendiği biçimi belirten dize HyperLinkField . Varsayılan değer, URL değerlerine özel biçimlendirme uygulanmadığını gösteren boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir nesnede DataNavigateUrlFormatString görüntülenen HyperLinkField köprülerin gezinti URL'lerine uygulanacak özel bir biçim belirtmek için özelliğinin nasıl kullanılacağını gösterir. özelliği tarafından DataTextField belirtilen alanın değeri, biçim dizesinde belirtilen bir Web sayfasına sorgu dizesi olarak geçirilir.


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

Açıklamalar

Bir nesnedeki DataNavigateUrlFormatString köprülerin URL'leri HyperLinkField için özel bir biçim belirtmek için özelliğini kullanın. DataNavigateUrlFormatString Özelliği ayarlanmadıysa, köprülerin URL'leri özel biçimlendirmeye sahip olmaz.

Uyarı

Biçim dizesi yalnızca DataNavigateUrlFields özellik ayarlandığında uygulanır.

Biçim dizesi herhangi bir değişmez değer dizesi olabilir ve genellikle alanın değeri için bir yer tutucu içerir. Örneğin, "Öğe Değeri: {0}" biçim dizesinde yer tutucu, {0} nesnedeki HyperLinkField alanın değeriyle değiştirilir. Biçim dizesinin geri kalanı değişmez metin olarak görüntülenir.

Uyarı

Biçim dizesi yer tutucu içermiyorsa, alanın veri kaynağındaki değeri son görüntüleme metnine dahil değildir.

Yer tutucu, iki nokta üst üste ile ayrılmış ve {A:Bxx} biçiminde ayraçlar halinde sarmalanmış iki bölümden oluşur. İki nokta üst üste işaretinden önceki değer (A genel örnekte), sıfır tabanlı parametre listesinde alan değerinin dizinini belirtir.

Uyarı

Bu parametre biçimlendirme söz diziminin bir parçasıdır. Her hücrede yalnızca bir alan değeri olduğundan, bu değer yalnızca 0 olarak ayarlanabilir.

İki nokta üst üste ve iki nokta üst üsteden sonraki değerler isteğe bağlıdır. İki nokta üst üste işaretinden sonraki karakter (B genel örnekte) değerin görüntüleneceği biçimi belirtir. Aşağıdaki tabloda ortak biçimler listelenmektedir.

Karakter biçimlendir Açıklama
C Sayısal değerleri para birimi biçiminde görüntüler.
D Sayısal değerleri ondalık biçiminde görüntüler.
E Sayısal değerleri bilimsel (üstel) biçimde görüntüler.
F Sayısal değerleri sabit biçimde görüntüler.
G Sayısal değerleri genel biçimde görüntüler.
N Sayısal değerleri sayı biçiminde görüntüler.
X Sayısal değerleri onaltılık biçimde görüntüler.

Uyarı

Biçim karakterleri, belirtilen durumda onaltılık karakterleri görüntüleyen dışında büyük X/küçük harfe duyarlı değildir.

Biçim karakterinden sonraki değer (xx genel örnekte) görüntülenecek önemli basamak sayısını veya ondalık basamak sayısını belirtir. Örneğin, "{0:F2}" biçim dizesi iki ondalık basamaklı sabit noktalı bir sayı görüntüler.

Dizeleri biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

Şunlara uygulanır

Ayrıca bkz.