TreeNodeBinding.FormatString Eigenschap

Definitie

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

Hiermee wordt de tekenreeks opgehaald of ingesteld waarmee de weergave-indeling wordt opgegeven voor de tekst van een knooppunt waarop het TreeNodeBinding object wordt toegepast.

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

Waarde van eigenschap

String

Een opmaaktekenreeks waarmee de weergave-indeling wordt opgegeven voor de tekst van een knooppunt waarop het TreeNodeBinding object wordt toegepast. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat de FormatString eigenschap niet is ingesteld.

Voorbeelden

Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u de FormatString eigenschap gebruikt om een aangepaste weergave-indeling op te geven voor de tekst die wordt weergegeven in het hoofdknooppunt. Het tweede codevoorbeeld bevat voorbeeld-XML-gegevens voor het eerste codevoorbeeld.

In het volgende codevoorbeeld ziet u hoe u de FormatString eigenschap gebruikt om een aangepaste weergave-indeling op te geven voor de tekst die wordt weergegeven in het hoofdknooppunt. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens kopiëren, die na dit codevoorbeeld zijn opgegeven, naar een bestand met de naam 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>

Het volgende codevoorbeeld is voorbeeld-XML-gegevens voor het voorgaande voorbeeld.

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

Opmerkingen

De FormatString eigenschap wordt gebruikt om een aangepaste indeling op te geven voor de tekst van een knooppunt. De tekenreeks voor gegevensindeling bestaat uit twee delen, gescheiden door een dubbele punt, in de vorm { A : Bxx }. De opmaaktekenreeks {0:F2} geeft bijvoorbeeld een vast puntnummer weer met twee decimalen.

Note

De hele tekenreeks moet tussen accolades staan om aan te geven dat het een notatietekenreeks is en geen letterlijke tekenreeks. Alle tekst buiten de accolades wordt weergegeven als letterlijke tekst.

De waarde vóór de dubbele punt (A in het algemene voorbeeld) geeft de parameterindex op in een op nul gebaseerde lijst met parameters.

Note

Deze waarde kan slechts worden ingesteld op 0 omdat er slechts één waarde in elk knooppunt is.

Het teken na de dubbele punt (B in het algemene voorbeeld) geeft de weergavenotatie voor de waarde op. De volgende tabel bevat de algemene notaties.

Teken opmaken Geeft numerieke waarden weer in
C Valutanotatie.
D Decimale notatie.
E Wetenschappelijke (exponentiële) notatie.
F Vaste indeling.
G Algemene indeling.
N Getalnotatie.
X Hexadecimale notatie.

Note

Met uitzondering van X, het notatieteken is niet hoofdlettergevoelig. In X het notatieteken worden de hexadecimale tekens weergegeven in het geval dat is opgegeven.

De waarde na het notatieteken (xx in het algemene voorbeeld) geeft het aantal significante cijfers of decimalen op dat moet worden weergegeven.

Zie Opmaaktypen voor meer informatie over het opmaken van tekenreeksen.

De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.

De waarde van de FormatString eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en LocalizableAttribute voor meer informatie.

Van toepassing op

Zie ook