HyperLinkField.DataNavigateUrlFormatString Özellik

  • Başvuru

Tanım

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

Nesnedeki HyperLinkField köprülerin URL'lerinin 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 HyperLinkField görüntülenen 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 Özellik ayarlanmadıysa, köprülerin URL'leri herhangi bir özel biçimlendirmeye sahip olmaz.

Not

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

Biçim dizesi herhangi bir değişmez dize 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.

Not

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 küme ayraçları içine alınmış iki bölümden oluşur. İki nokta üst üste işaretinden önceki değer (A genel örnekte) alan değerinin dizinini sıfır tabanlı parametre listesinde belirtir.

Not

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 üste sonrasındaki 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 listeledik.

Biçim karakteri Description
C Sayısal değerleri para birimi biçiminde görüntüler.
D Sayısal değerleri ondalık biçimde 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.

Not

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

Biçim karakterinden sonraki değer (xx genel örnekte) görüntülenecek anlamlı basamak 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.