Freigeben über

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 die FormatString -Eigenschaft verwendet wird, um ein benutzerdefiniertes Anzeigeformat für den Text anzugeben, der im Stammknoten angezeigt wird. Das zweite Codebeispiel enthält XML-Beispieldaten für das erste Codebeispiel.

Im folgenden Codebeispiel wird veranschaulicht, wie die FormatString -Eigenschaft verwendet wird, um ein benutzerdefiniertes Anzeigeformat für den text anzugeben, der im Stammknoten angezeigt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei namens Book.xml kopieren.


<%@ 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 enthält XML-Beispieldaten 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 Format { A : Bxx }. Die Formatierungszeichenfolge {0:F2} zeigt beispielsweise eine Festpunktzahl 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 geschweiften Klammern 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 auf jedem Knoten nur ein Wert 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 gängigen Formate aufgeführt.

Formatieren von Zeichen 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 Xwird beim Formatzeichen die Groß-/Kleinschreibung nicht beachtet. Das X Formatzeichen zeigt die Hexadezimalzeichen in dem angegebenen Fall an.

Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl der anzuzeigenden signifikanten Ziffern oder Dezimalstellen an.

Weitere Informationen zum Formatieren von Zeichenfolgen finden Sie unter Formatierungstypen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

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

Gilt für:

Weitere Informationen