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 dla 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 zastosowano 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 oddzielonych dwukropkiem w postaci { : A Bxx }. Na przykład ciąg {0:F2} formatowania wyświetla stałą liczbę 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 klamrowych 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 opartych na zera.

Uwaga

Tę wartość można ustawić tylko na wartość 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 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 Naprawiono format.
G Format ogólny.
N Format liczbowy.
X Format szesnastkowy.

Uwaga

Z wyjątkiem znaku Xformatu 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 Formatting Types (Typy formatowania).

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

Wartość FormatString właściwości, po ustawieniu, można zapisać automatycznie w pliku zasobów przy użyciu narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttribute temat Globalizacja i Lokalizacja.

Dotyczy

Zobacz też