Bagikan melalui

HyperLinkField.DataTextFormatString Properti

Definisi

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

Mendapatkan atau mengatur string yang menentukan format di mana keterangan hyperlink dalam HyperLinkField objek ditampilkan.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Nilai Properti

String

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

Contoh

Contoh kode berikut menunjukkan cara menggunakan DataTextFormatString properti untuk memformat nilai yang terikat ke keterangan hyperlink yang HyperLinkField ditampilkan dalam objek. Nilai diformat sebagai mata uang.


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

DataTextFormatString Gunakan properti untuk menentukan format tampilan kustom untuk keterangan yang ditampilkan dalam HyperLinkField objek. DataTextFormatString Jika properti tidak diatur, nilai bidang ditampilkan tanpa pemformatan khusus.

Nota

String format hanya diterapkan saat DataTextField 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 saat ditampilkan di 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