TreeNodeBinding.FormatString Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Nesnenin uygulandığı düğümün metni için görüntüleme biçimini belirten dizeyi TreeNodeBinding alır veya ayarlar.

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

Özellik Değeri

String

Nesnenin uygulandığı düğümün TreeNodeBinding metni için görüntüleme biçimini belirten biçimlendirme dizesi. Varsayılan, özelliğin FormatString ayarlanmadığını gösteren boş bir dizedir ("").

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneği, kök düğümde FormatString görüntülenen metin için özel bir görüntüleme biçimi belirtmek üzere özelliğinin nasıl kullanılacağını gösterir. İkinci kod örneği, ilk kod örneği için örnek XML verileri sağlar.

Aşağıdaki kod örneği, kök düğümde FormatString görüntülenen metin için özel bir görüntüleme biçimi belirtmek üzere özelliğinin nasıl kullanılacağını gösterir. Bu örneğin doğru çalışması için, bu kod örneğinden sonra sağlanan örnek XML verilerini Book.xml adlı bir dosyaya kopyalamanız gerekir.


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

Aşağıdaki kod örneği, önceki örnek için örnek XML verileridir.

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

Açıklamalar

FormatString özelliği, bir düğümün metni için özel bir biçim sağlamak için kullanılır. Veri biçimi dizesi, { A : Bxx } biçiminde iki nokta üst üste ile ayrılmış iki bölümden oluşur. Örneğin, biçimlendirme dizesi {0:F2} iki ondalık basamaklı sabit noktalı bir sayı görüntüler.

Not

Dizenin tamamının, değişmez değer dizesi değil biçim dizesi olduğunu belirtmek için küme ayraçları içine alınması gerekir. Ayraçların dışındaki tüm metinler değişmez metin olarak görüntülenir.

İki nokta üst üsteA (genel örnekte) öncesindeki değer, parametre dizinini sıfır tabanlı parametre listesinde belirtir.

Not

Her düğümde yalnızca bir değer olduğundan bu değer yalnızca 0 olarak ayarlanabilir.

İki nokta üst üste işaretinden sonraki karakter (B genel örnekte) değerin görüntüleme biçimini belirtir. Aşağıdaki tabloda yaygın biçimler listelenmektedir.

Biçim karakteri	içindeki sayısal değerleri görüntüler
`C`	Para birimi biçimi.
`D`	Ondalık biçim.
`E`	Bilimsel (üstel) biçim.
`F`	Sabit biçim.
`G`	Genel biçim.
`N`	Sayı biçimi.
`X`	Onaltılık biçim.

Not

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

Biçim karakterinden sonraki değer (xx genel örnekte) görüntülenecek anlamlı basamak veya ondalık basamak sayısını belirtir.

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

Bu özelliğin değeri görünüm durumunda depolanır.

Özelliğin FormatString değeri ayarlandığında, tasarımcı aracı kullanılarak otomatik olarak bir kaynak dosyasına kaydedilebilir. Daha fazla bilgi için bkz LocalizableAttribute . ve Genelleştirme ve Yerelleştirme.

Şunlara uygulanır

Aracılığıyla paylaş