TreeNodeBinding.FormatString Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die Zeichenfolge ab, mit der das Anzeigeformat für den Text eines Knotens angegeben wird, für den das TreeNodeBinding-Objekt angewendet wird, oder legt diese Zeichenfolge fest.

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

Eigenschaftswert

String

Eine Formatierungszeichenfolge, mit der das Anzeigeformat für den Text eines Knotens angegeben wird, auf den das TreeNodeBinding-Objekt angewendet wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die FormatString-Eigenschaft nicht festgelegt ist.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Sie mithilfe der FormatString Eigenschaft ein benutzerdefiniertes Anzeigeformat für den text angeben, der im Stammknoten angezeigt wird. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitgestellt.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der FormatString Eigenschaft ein benutzerdefiniertes Anzeigeformat für den im Stammknoten angezeigten Text angeben. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten kopieren, die nach diesem Codebeispiel angegeben wurden, in eine Datei mit dem Namen 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>

Das folgende Codebeispiel ist Beispiel-XML-Daten für das vorherige Beispiel.

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

Hinweise

Die FormatString Eigenschaft wird verwendet, um ein benutzerdefiniertes Format für den Text eines Knotens bereitzustellen. Die Datenformatzeichenfolge besteht aus zwei Teilen, getrennt durch einen Doppelpunkt, im Formular { A : Bxx }. Die Formatierungszeichenfolge {0:F2} zeigt beispielsweise eine Feste Punktzahl mit zwei Dezimalstellen an.

Hinweis

Die gesamte Zeichenfolge muss in geschweifte Klammern eingeschlossen werden, um anzugeben, dass es sich um eine Formatzeichenfolge und nicht um eine Literalzeichenfolge handelt. Jeder Text außerhalb der Geschweifte wird als Literaltext angezeigt.

Der Wert vor dem Doppelpunkt (A im allgemeinen Beispiel) gibt den Parameterindex in einer nullbasierten Liste von Parametern an.

Hinweis

Dieser Wert kann nur auf 0 festgelegt werden, da nur ein Wert in jedem Knoten vorhanden ist.

Das Zeichen nach dem Doppelpunkt (B im allgemeinen Beispiel) gibt das Anzeigeformat für den Wert an. In der folgenden Tabelle sind die allgemeinen Formate aufgeführt.

Zeichen formatieren Zeigt numerische Werte in
C Währungsformat.
D Dezimalformat.
E Wissenschaftliches (exponentielles) Format.
F Festes Format.
G Allgemeines Format.
N Zahlenformat.
X Hexadezimalformat.

Hinweis

Mit Ausnahme von X, ist das Formatzeichen nicht groß und kleinschreibungsempfindlich. Das X Formatzeichen zeigt die Hexadezimalzeichen im angegebenen Fall an.

Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl von signifikanten Ziffern oder Dezimalstellen an, die angezeigt werden sollen.

Weitere Informationen zum Formatieren von Zeichenfolgen finden Sie unter Formatierungstypen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Der Wert der FormatString Eigenschaft, wenn festgelegt, kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.

Gilt für

Siehe auch