Aracılığıyla paylaş

TreeNodeBinding.FormatString Özellik

Tanım

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

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ü 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ü 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.xmladlı 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 örneğe ilişkin ö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, 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.

Uyarı

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

İki nokta üst üsteden önceki değer (A genel örnekte) parametre dizinini sıfır tabanlı parametre listesinde belirtir.

Uyarı

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ü biçimini belirtir. Aşağıdaki tabloda ortak biçimler listelenmektedir.

Karakter biçimlendir içinde 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.

Uyarı

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 önemli basamak sayısını 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, bir 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

Ayrıca bkz.