Udostępnij za pośrednictwem

TreeNodeBinding.FormatString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia ciąg określający format wyświetlania tekstu węzła, do którego TreeNodeBinding jest stosowany obiekt.

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

Wartość właściwości

String

Ciąg formatowania określający format wyświetlania tekstu węzła, do którego TreeNodeBinding jest stosowany obiekt. Wartość domyślna to pusty ciąg (""), który wskazuje, że właściwość nie jest ustawiona FormatString .

Przykłady

Ten rozdział zawiera dwa przykłady kodu. W pierwszym przykładzie kodu pokazano, jak za pomocą FormatString właściwości określić niestandardowy format wyświetlania tekstu wyświetlanego w węźle głównym. Drugi przykład kodu zawiera przykładowe dane XML dla pierwszego przykładu kodu.

W poniższym przykładzie kodu pokazano, jak za pomocą FormatString właściwości określić niestandardowy format wyświetlania tekstu wyświetlanego w węźle głównym. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML podane po tym przykładzie kodu do pliku o nazwie 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>

Poniższy przykład kodu to przykładowe dane XML dla poprzedniego przykładu.

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

Uwagi

Właściwość FormatString służy do udostępniania niestandardowego formatu tekstu węzła. Ciąg formatu danych składa się z dwóch części rozdzielonych dwukropkiem w postaci { : ABxx }. Na przykład ciąg {0:F2} formatowania wyświetla liczbę o stałym punkcie z dwoma miejscami dziesiętnymi.

Uwaga

Cały ciąg musi być ujęty w nawiasy klamrowe, aby wskazać, że jest to ciąg formatu, a nie ciąg literału. Dowolny tekst poza nawiasami klamrowym jest wyświetlany jako tekst literału.

Wartość przed dwukropkiem (A w ogólnym przykładzie) określa indeks parametrów na liście parametrów na podstawie zera.

Uwaga

Tę wartość można ustawić tylko na 0, ponieważ w każdym węźle istnieje tylko jedna wartość.

Znak po dwukropku (B w ogólnym przykładzie) określa format wyświetlania dla wartości. W poniższej tabeli wymieniono typowe formaty.

Formatuj znak Wyświetla wartości liczbowe w
C Format waluty.
D Format dziesiętny.
E Format naukowy (wykładniczy).
F Stały format.
G Format ogólny.
N Format liczbowy.
X Format szesnastkowy.

Uwaga

XZ wyjątkiem znaku formatu nie jest uwzględniana wielkość liter. Znak X formatu wyświetla znaki szesnastkowe w określonym przypadku.

Wartość po znaku formatu (xx w ogólnym przykładzie) określa liczbę cyfr znaczących lub miejsc dziesiętnych do wyświetlenia.

Aby uzyskać więcej informacji na temat formatowania ciągów, zobacz Typy formatowania.

Wartość tej właściwości jest przechowywana w stanie widoku.

Wartość FormatString właściwości, gdy jest ustawiona, można automatycznie zapisać w pliku zasobów za pomocą narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttributeGlobalization and Localization (Globalizacja i lokalizacja).

Dotyczy

Zobacz też