Partager via


TreeNodeBinding.FormatString Propriété

Définition

Obtient ou définit la chaîne qui spécifie le format d'affichage du texte d'un nœud auquel l'objet TreeNodeBinding est appliqué.

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

Valeur de propriété

Une chaîne de mise en forme qui spécifie le format d'affichage du texte d'un nœud auquel l'objet TreeNodeBinding est appliqué. La valeur par défaut est une chaîne vide (" "), ce qui signifie que la propriété FormatString n'est pas définie.

Exemples

Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser la FormatString propriété pour spécifier un format d’affichage personnalisé pour le texte affiché dans le nœud racine. Le deuxième exemple de code fournit des exemples de données XML pour le premier exemple de code.

L’exemple de code suivant montre comment utiliser la FormatString propriété pour spécifier un format d’affichage personnalisé pour le texte affiché dans le nœud racine. Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML, fournis après cet exemple de code, dans un fichier nommé 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’exemple de code suivant est un exemple de données XML pour l’exemple précédent.

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

Remarques

La FormatString propriété est utilisée pour fournir un format personnalisé pour le texte d’un nœud. La chaîne de format de données se compose de deux parties, séparées par un deux-points, sous la forme { A : Bxx }. Par exemple, la chaîne {0:F2} de mise en forme affiche un nombre à virgule fixe avec deux décimales.

Notes

La chaîne entière doit être placée entre accolades pour indiquer qu’il s’agit d’une chaîne de format et non d’une chaîne littérale. Tout texte en dehors des accolades s’affiche sous forme de texte littéral.

La valeur avant les deux-points (A dans l’exemple général) spécifie l’index de paramètre dans une liste de paramètres de base zéro.

Notes

Cette valeur ne peut être définie que sur 0, car il n’y a qu’une seule valeur dans chaque nœud.

Le caractère après les deux-points (B dans l’exemple général) spécifie le format d’affichage de la valeur. Le tableau suivant répertorie les formats courants.

Caractère de mise en forme Affiche les valeurs numériques dans
C Format monétaire.
D Format décimal.
E Format scientifique (exponentiel).
F Format fixe.
G Format général.
N Format de nombre.
X Format hexadécimal.

Notes

À l’exception de X, le caractère de format ne respecte pas la casse. Le X caractère de format affiche les caractères hexadécimaux dans le cas spécifié.

La valeur après le caractère de format (xx dans l’exemple général) spécifie le nombre de chiffres significatifs ou de décimales à afficher.

Pour plus d’informations sur la mise en forme des chaînes, consultez Mise en forme des types.

La valeur de cette propriété est stockée dans l’état d’affichage.

La valeur de la FormatString propriété, lorsqu’elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de concepteur. Pour plus d’informations, consultez LocalizableAttributeet Globalisation et localisation.

S’applique à

Voir aussi