Sdílet prostřednictvím

TreeNodeBinding.FormatString Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví řetězec, který určuje formát zobrazení pro text uzlu, na který TreeNodeBinding je objekt použit.

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

Hodnota vlastnosti

String

Formátovací řetězec, který určuje formát zobrazení pro text uzlu, na který TreeNodeBinding je objekt použit. Výchozí hodnota je prázdný řetězec (""), který označuje, že FormatString vlastnost není nastavena.

Příklady

Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak pomocí FormatString vlastnosti určit vlastní formát zobrazení pro text, který se zobrazí v kořenovém uzlu. Druhý příklad kódu poskytuje ukázková data XML pro první příklad kódu.

Následující příklad kódu ukazuje použití FormatString vlastnosti k určení vlastní formát zobrazení pro text, který je zobrazen v kořenovém uzlu. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML zadanou po tomto příkladu kódu do souboru s názvem 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>

Následující příklad kódu je ukázková data XML pro předchozí příklad.

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

Poznámky

Tato FormatString vlastnost slouží k poskytnutí vlastního formátu textu uzlu. Řetězec formátu dat se skládá ze dvou částí oddělených dvojtečkami ve tvaru { A : Bxx }. Například formátovací řetězec {0:F2} zobrazí číslo s pevným bodem se dvěma desetinnými místy.

Poznámka:

Celý řetězec musí být uzavřený ve složených závorkách, aby bylo možné označit, že se jedná o formátovací řetězec, nikoli literálový řetězec. Libovolný text mimo složené závorky se zobrazí jako literálový text.

Hodnota před dvojtečku (A v obecném příkladu) určuje index parametrů v seznamu parametrů založených na nule.

Poznámka:

Tuto hodnotu lze nastavit pouze na 0, protože v každém uzlu je pouze jedna hodnota.

Znak za dvojtečku (B v obecném příkladu) určuje formát zobrazení hodnoty. Následující tabulka uvádí běžné formáty.

Formát znaku Zobrazí číselné hodnoty v
C Formát měny.
D Desetinný formát.
E Vědecký (exponenciální) formát.
F Pevný formát.
G Obecný formát.
N Formát čísla
X Šestnáctkový formát.

Poznámka:

Kromě znaku Xformátu se nerozlišuje malá a velká písmena. Znak X formátu zobrazí šestnáctkové znaky v zadaném případě.

Hodnota za znakem formátu (xx v obecném příkladu) určuje počet platných číslic nebo desetinných míst, která se mají zobrazit.

Další informace o formátování řetězců naleznete v tématu Typy formátování.

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Hodnotu FormatString vlastnosti lze při nastavení automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace naleznete v tématu LocalizableAttribute a globalizace a lokalizace.

Platí pro

Viz také