Nyelv

TreeNodeBinding.FormatString Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Lekéri vagy beállítja az objektumot alkalmazó csomópont TreeNodeBinding szövegének megjelenítési formátumát meghatározó sztringet.

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

Tulajdonság értéke

String

Egy formázási sztring, amely megadja annak a csomópontnak a szövegének megjelenítési formátumát, amelyre az TreeNodeBinding objektumot alkalmazza. Az alapértelmezett érték egy üres sztring (""), amely azt jelzi, hogy a FormatString tulajdonság nincs beállítva.

Példák

Ez a szakasz két példakódot tartalmaz. Az első példakód bemutatja, hogyan használható a FormatString tulajdonság a gyökércsomóponton megjelenő szöveg egyéni megjelenítési formátumának megadására. A második példa xml-mintaadatokat biztosít az első kód példájához.

Az alábbi példakód bemutatja, hogyan használható a FormatString tulajdonság a gyökércsomóponton megjelenő szöveg egyéni megjelenítési formátumának megadására. Ahhoz, hogy ez a példa megfelelően működjön, a példakód után megadott XML-mintaadatokat egy Book.xmlnevű fájlba kell másolnia.


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

Az alábbi példakód az előző példához tartozó XML-mintaadatokat tartalmazza.

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

Megjegyzések

A FormatString tulajdonság egy csomópont szövegének egyéni formátumát adja meg. Az adatformátum-sztring két részből áll, kettősponttal elválasztva{ A : Bxx }. A formázási sztring {0:F2} például két tizedesjegyet tartalmazó rögzített pontszámot jelenít meg.

Note

A teljes sztringet kapcsos zárójelek közé kell tenni, hogy azt jelezze, hogy formátumsztring, nem pedig literális sztring. A kapcsos zárójelen kívüli szövegek konstans szövegként jelennek meg.

A kettőspont előtti érték (A az általános példában) a paraméterek nulla alapú listájában adja meg a paraméterindexet.

Note

Ez az érték csak 0 értékre állítható be, mert minden csomópontban csak egy érték van.

A kettőspont utáni karakter (B az általános példában) az érték megjelenítési formátumát adja meg. Az alábbi táblázat a gyakori formátumokat sorolja fel.

Karakter formázása Numerikus értékek megjelenítése a következőben:
C Pénznemformátum.
D Decimális formátum.
E Tudományos (exponenciális) formátum.
F Rögzített formátum.
G Általános formátum.
N Számformátum.
X Hexadecimális formátum.

Note

XKivéve, hogy a formátum karakter nem megkülönbözteti a kis- és nagybetűt. A X formátumkarakterek a megadott esetben a hexadecimális karaktereket jelenítik meg.

A formátum karakter utáni érték (xx az általános példában) a megjelenítendő jelentős számjegyek vagy tizedesjegyek számát határozza meg.

A sztringek formázásáról további információt a Formázási típusok című témakörben talál.

Ennek a tulajdonságnak az értéke megtekintési állapotban van tárolva.

Ha be van állítva, a FormatString tulajdonság értéke automatikusan menthető egy erőforrásfájlba egy tervezőeszköz használatával. További információkért tekintse meg és tekintse meg LocalizableAttribute a globalizációt és a honosítást.

A következőre érvényes:

Lásd még