Bagikan melalui

HyperLinkField.DataNavigateUrlFormatString Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur string yang menentukan format di mana URL untuk hyperlink dalam objek dirender HyperLinkField .

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

Nilai Properti

String

String yang menentukan format di mana URL untuk hyperlink dalam dirender HyperLinkField . Defaultnya adalah string kosong (""), yang menunjukkan bahwa tidak ada pemformatan khusus yang diterapkan ke nilai URL.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DataNavigateUrlFormatString properti untuk menentukan format kustom yang akan diterapkan ke URL navigasi hyperlink yang HyperLinkField ditampilkan dalam objek. Nilai bidang yang ditentukan oleh DataTextField properti diteruskan sebagai string kueri ke halaman Web yang ditentukan dalam string format.


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

Keterangan

DataNavigateUrlFormatString Gunakan properti untuk menentukan format kustom untuk URL hyperlink dalam HyperLinkField objek. DataNavigateUrlFormatString Jika properti tidak diatur, URL hyperlink tidak mendapatkan pemformatan khusus.

Nota

String format hanya diterapkan saat DataNavigateUrlFields properti diatur.

String format dapat berupa string harfiah apa pun dan biasanya menyertakan tempat penampung untuk nilai bidang. Misalnya, dalam string format "Nilai Item: {0}", {0} tempat penampung diganti dengan nilai bidang dalam HyperLinkField objek. String format lainnya ditampilkan sebagai teks harfiah.

Nota

Jika string format tidak menyertakan tempat penampung, nilai bidang dari sumber data tidak disertakan dalam teks tampilan akhir.

Tempat penampung terdiri dari dua bagian, dipisahkan oleh titik dua dan dibungkus kurung kurawal, dalam bentuk {A:Bxx}. Nilai sebelum titik dua (A dalam contoh umum) menentukan indeks nilai bidang dalam daftar parameter berbasis nol.

Nota

Parameter ini adalah bagian dari sintaks pemformatan. Karena hanya ada satu nilai bidang di setiap sel, nilai ini hanya dapat diatur ke 0.

Titik dua dan nilai setelah titik dua bersifat opsional. Karakter setelah titik dua (B dalam contoh umum) menentukan format untuk menampilkan nilai. Tabel berikut mencantumkan format umum.

Format karakter Deskripsi
C Menampilkan nilai numerik dalam format mata uang.
D Menampilkan nilai numerik dalam format desimal.
E Menampilkan nilai numerik dalam format ilmiah (eksponensial).
F Menampilkan nilai numerik dalam format tetap.
G Menampilkan nilai numerik dalam format umum.
N Menampilkan nilai numerik dalam format angka.
X Menampilkan nilai numerik dalam format heksadesimal.

Nota

Karakter format tidak peka huruf besar/kecil, kecuali , Xyang menampilkan karakter heksadesimal dalam kasus yang ditentukan.

Nilai setelah karakter format (xx dalam contoh umum) menentukan jumlah digit signifikan atau tempat desimal yang akan ditampilkan. Misalnya, string format "{0:F2}" menampilkan angka titik tetap dengan dua tempat desimal.

Untuk informasi selengkapnya tentang pemformatan string, lihat Tipe Pemformatan.

Berlaku untuk

Lihat juga