Sdílet prostřednictvím

TreeNodeBinding.FormatString Vlastnost

  • Reference

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 použít FormatString vlastnost k určení vlastního formátu zobrazení pro text, který je zobrazen 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, jak použít FormatString vlastnost k určení vlastního formátu 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 za tímto příkladem 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 jsou 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

Vlastnost FormatString se používá k poskytnutí vlastního formátu pro text uzlu. Řetězec formátu dat se skládá ze dvou částí oddělených dvojtečka ve tvaru { A : Bxx }. Formátovací řetězec {0:F2} například zobrazuje číslo s pevnou čárkou 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, a ne o řetězec literálu. Jakýkoli text mimo závorky se zobrazí jako literálový text.

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

Poznámka

Tuto hodnotu lze nastavit pouze na hodnotu 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í pro hodnotu. V následující tabulce jsou uvedené 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

S výjimkou Xznaku formátu se nerozlišuje velká a malá písmena. Formátovací X znak 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ů najdete v tématu Typy formátování.

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

Hodnota FormatString vlastnosti, pokud je nastavená, se dá automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace najdete v tématech LocalizableAttributeGlobalizace a lokalizace.

Platí pro

Viz také