TreeNodeBinding.FormatString Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger strängen som anger visningsformatet för texten i en nod som TreeNodeBinding objektet tillämpas på.

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

Egenskapsvärde

String

En formateringssträng som anger visningsformatet för texten i en nod som TreeNodeBinding objektet tillämpas på. Standardvärdet är en tom sträng (""), som anger att egenskapen FormatString inte har angetts.

Exempel

Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du använder FormatString egenskapen för att ange ett anpassat visningsformat för texten som visas i rotnoden. Det andra kodexemplet innehåller XML-exempeldata för det första kodexemplet.

Följande kodexempel visar hur du använder FormatString egenskapen för att ange ett anpassat visningsformat för texten som visas i rotnoden. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata, som tillhandahålls efter det här kodexemplet, till en fil med namnet 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>

Följande kodexempel är XML-exempeldata för föregående exempel.

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

Kommentarer

Egenskapen FormatString används för att ange ett anpassat format för en nods text. Dataformatsträngen består av två delar, avgränsade med ett kolon, i formatet { A : Bxx }. Formateringssträngen {0:F2} visar till exempel ett fast punktnummer med två decimaler.

Note

Hela strängen måste omges av klammerparenteser för att indikera att det är en formatsträng och inte en literalsträng. All text utanför klammerparenteserna visas som literaltext.

Värdet före kolonet (A i det allmänna exemplet) anger parameterindexet i en nollbaserad lista med parametrar.

Note

Det här värdet kan bara anges till 0 eftersom det bara finns ett värde i varje nod.

Tecknet efter kolonet (B i det allmänna exemplet) anger visningsformatet för värdet. I följande tabell visas de vanliga formaten.

Formattecken Visar numeriska värden i
C Valutaformat.
D Decimalformat.
E Vetenskapligt (exponentiellt) format.
F Fast format.
G Allmänt format.
N Talformat.
X Hexadecimalt format.

Note

XFörutom är formattecknet inte skiftlägeskänsligt. Formattecknet X visar hexadecimala tecken i det angivna fallet.

Värdet efter formattecknet (xx i det allmänna exemplet) anger antalet signifikanta siffror eller decimaler som ska visas.

Mer information om formateringssträngar finns i Formateringstyper.

Värdet för den här egenskapen lagras i visningstillstånd.

Värdet för egenskapen kan när den FormatString anges sparas automatiskt i en resursfil med hjälp av ett designerverktyg. Mer information finns i LocalizableAttributeglobalisering och lokalisering.

Gäller för

Se även