Condividi tramite

TreeNodeBinding.FormatString Proprietà

Definizione

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

Ottiene o imposta la stringa che specifica il formato di visualizzazione per il testo di un nodo a cui viene 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 per il testo di un nodo a cui viene applicato l'oggetto TreeNodeBinding . Il valore predefinito è una stringa vuota (""), che indica che la FormatString proprietà non è impostata.

Esempio

Questa sezione contiene 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 utilizzare la FormatString proprietà per specificare un formato di visualizzazione personalizzato per il testo visualizzato nel nodo radice. Affinché questo esempio funzioni correttamente, è 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>

L'esempio di codice seguente è costituito da 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 utilizzata 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.

Annotazioni

L'intera stringa deve essere racchiusa tra parentesi graffe per indicare che si tratta di una stringa di formato e non di una stringa letterale. Qualsiasi testo all'esterno delle 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 in base zero di parametri.

Annotazioni

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 numerico.
X Formato esadecimale.

Annotazioni

Ad eccezione di X, il carattere di formato non fa 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 Formattazione dei tipi.

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

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

Si applica a

Vedi anche