Bagikan melalui

TreeNodeBinding.FormatString Properti

  • Referensi

Definisi

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

Mendapatkan atau mengatur string yang menentukan format tampilan untuk teks simpul tempat TreeNodeBinding objek diterapkan.

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

Nilai Properti

String

String pemformatan yang menentukan format tampilan untuk teks simpul tempat TreeNodeBinding objek diterapkan. Defaultnya adalah string kosong (""), yang menunjukkan bahwa FormatString properti tidak diatur.

Contoh

Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menggunakan FormatString properti untuk menentukan format tampilan kustom untuk teks yang ditampilkan di simpul akar. Contoh kode kedua menyediakan contoh data XML untuk contoh kode pertama.

Contoh kode berikut menunjukkan cara menggunakan FormatString properti untuk menentukan format tampilan kustom untuk teks yang ditampilkan di simpul akar. Agar contoh ini berfungsi dengan benar, Anda harus menyalin data XML sampel, yang disediakan setelah contoh kode ini, ke file bernama Book.xml.


<%@ 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>TreeNodeBinding FormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding FormatString Example</h3>
    
      <!-- Use the FormatString property to apply   -->
      <!-- a custom format string to the root node. -->
      <!-- The placeholder ({0}) is automatically   -->
      <!-- replaced with the value of the field     -->
      <!-- specified in the TextField property.     -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0"
            TextField="Title" 
            FormatString="Best Seller: {0}"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </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>TreeNodeBinding FormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding FormatString Example</h3>
    
      <!-- Use the FormatString property to apply   -->
      <!-- a custom format string to the root node. -->
      <!-- The placeholder ({0}) is automatically   -->
      <!-- replaced with the value of the field     -->
      <!-- specified in the TextField property.     --> 
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0"
            TextField="Title" 
            FormatString="Best Seller: {0}"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

Contoh kode berikut adalah contoh data XML untuk contoh sebelumnya.

<Book Title="Book Title">  
    <Chapter Heading="Chapter 1">  
        <Section Heading="Section 1">  
        </Section>  
        <Section Heading="Section 2">  
        </Section>  
    </Chapter>  
    <Chapter Heading="Chapter 2">  
        <Section Heading="Section 1">  
        </Section>  
    </Chapter>  
    <Appendix Heading="Appendix A">  
    </Appendix>  
</Book>

Keterangan

Properti FormatString digunakan untuk menyediakan format kustom untuk teks simpul. String format data terdiri dari dua bagian, dipisahkan oleh titik dua, dalam bentuk { A : Bxx }. Misalnya, string {0:F2} pemformatan menampilkan angka titik tetap dengan dua tempat desimal.

Catatan

Seluruh string harus diapit kurung kurawal untuk menunjukkan bahwa string format dan bukan string harfiah. Teks apa pun di luar kurung kurawal ditampilkan sebagai teks harfiah.

Nilai sebelum titik dua (A dalam contoh umum) menentukan indeks parameter dalam daftar parameter berbasis nol.

Catatan

Nilai ini hanya dapat diatur ke 0 karena hanya ada satu nilai di setiap simpul.

Karakter setelah titik dua (B dalam contoh umum) menentukan format tampilan untuk nilai . Tabel berikut ini mencantumkan format umum.

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

Catatan

Kecuali untuk X, karakter format tidak peka huruf besar/kecil. Karakter X format menampilkan karakter heksadesimal dalam kasus yang ditentukan.

Nilai setelah karakter format (xx dalam contoh umum) menentukan jumlah digit signifikan atau tempat desimal untuk ditampilkan.

Untuk informasi selengkapnya tentang string pemformatan, lihat Jenis Pemformatan.

Nilai properti ini disimpan dalam status tampilan.

Nilai FormatString properti, saat diatur, dapat disimpan secara otomatis ke file sumber daya dengan menggunakan alat perancang. Untuk informasi selengkapnya, lihat LocalizableAttribute dan Globalisasi dan Pelokalan.

Berlaku untuk

Lihat juga