Share via

TreeNodeBinding.FormatString Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la stringa che specifica il formato di visualizzazione del testo di un nodo a cui è applicato l'oggetto TreeNodeBinding.

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

Valore della proprietà

String

Stringa di formattazione che specifica il formato di visualizzazione del testo di un nodo a cui è applicato l'oggetto TreeNodeBinding. Il valore predefinito è una stringa vuota (""), che indica che la proprietà FormatString non è impostata.

Esempio

In questa sezione sono riportati due esempi di codice. Il primo esempio di codice illustra come usare la FormatString proprietà per specificare un formato di visualizzazione personalizzato per il testo visualizzato nel nodo radice. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.

Nell'esempio di codice seguente viene illustrato come usare la FormatString proprietà per specificare un formato di visualizzazione personalizzato per il testo visualizzato nel nodo radice. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato 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>

Nell'esempio di codice seguente sono riportati dati XML di esempio per l'esempio precedente.

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

Commenti

La FormatString proprietà viene usata per fornire un formato personalizzato per il testo di un nodo. La stringa di formato dati è costituita da due parti, separate da due punti, nel formato { A : Bxx }. Ad esempio, la stringa {0:F2} di formattazione visualizza un numero a virgola fissa con due posizioni decimali.

Nota

L'intera stringa deve essere racchiusa tra parentesi graffe per indicare che è una stringa di formato e non una stringa letterale. Qualsiasi testo esterno alle parentesi graffe viene visualizzato come testo letterale.

Il valore prima dei due punti (A nell'esempio generale) specifica l'indice dei parametri in un elenco di parametri in base zero.

Nota

Questo valore può essere impostato solo su 0 perché in ogni nodo è presente un solo valore.

Il carattere dopo i due punti (B nell'esempio generale) specifica il formato di visualizzazione per il valore. Nella tabella seguente sono elencati i formati comuni.

Formato carattere Visualizza i valori numerici in
C Formato valuta.
D Formato decimale.
E Formato scientifico (esponenziale).
F Formato fisso.
G Formato generale.
N Formato numero.
X Formato esadecimale.

Nota

XAd eccezione di , il carattere di formato non è distinzione tra maiuscole e minuscole. Il X carattere di formato visualizza i caratteri esadecimali nel caso specificato.

Il valore dopo il carattere di formato (xx nell'esempio generale) specifica il numero di cifre significative o cifre decimali da visualizzare.

Per altre informazioni sulla formattazione delle stringhe, vedere Formatting Types (Formattazione dei tipi).

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Il valore della proprietà, quando impostato, può essere salvato automaticamente in un file di FormatString risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttributee Globalizzazione e Localizzazione.

Si applica a

Vedi anche