TreeView.AutoGenerateDataBindings Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit une valeur indiquant si le contrôle TreeView génère automatiquement des liaisons de nœud d'arbre.

public:
 property bool AutoGenerateDataBindings { bool get(); void set(bool value); };
public bool AutoGenerateDataBindings { get; set; }
member this.AutoGenerateDataBindings : bool with get, set
Public Property AutoGenerateDataBindings As Boolean

Valeur de propriété

Boolean

true pour que le contrôle TreeView génère automatiquement des liaisons de nœud d'arbre ; sinon, false. La valeur par défaut est true.

Exemples

Cette section contient deux exemples de code. Le premier exemple de code montre comment désactiver la génération automatique de liaison de nœud d’arbre en définissant la propriété falsesur AutoGenerateDataBindings . Le deuxième exemple de code fournit des exemples de données de carte de site pour le premier exemple de code.

L’exemple de code suivant montre comment désactiver la génération automatique de liaison de nœud d’arbre en définissant la propriété falsesur AutoGenerateDataBindings . Une DataBindings collection est ensuite définie pour établir la relation entre les éléments de données d’un SiteMapDataSource contrôle et les nœuds du TreeView contrôle. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données de carte de site, fournie après cet exemple de code, dans un fichier nommé Web.blueprint.


<%@ 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>TreeView AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </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>TreeView AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </form>
  </body>
</html>

L’exemple de code suivant fournit des exemples de données de carte de site pour l’exemple précédent.

<siteMap>
    <siteMapNode title="Home" description="Home" url="default.aspx">
        <siteMapNode title="Products" description="Products" url="Products.aspx">
            <siteMapNode title="Computers" url="Computers.aspx"/>
            <siteMapNode title="Accessories" url="Accessories.aspx"/>
        </siteMapNode>
    </siteMapNode>
</siteMap>

Remarques

Les liaisons de nœud d’arborescence définissent la relation entre un élément de données et le nœud auquel il est liés. Lors de la liaison à une source de données où chaque élément de données contient plusieurs propriétés (comme un élément XML avec plusieurs attributs), le TreeView contrôle doit connaître la propriété d’élément de données à lier à quelle TreeNode propriété. Si la AutoGenerateDataBindings propriété est définie truesur , le TreeView contrôle génère automatiquement des liaisons de nœud d’arbre par défaut qui définissent la Text propriété de l’objet TreeNode associé à la liaison à la valeur retournée par la ToString méthode de l’élément de données.

Notes

Les liaisons de nœud d’arbre générées automatiquement ne sont pas ajoutées à la DataBindings collection.

Dans le cas d’un élément XML, la valeur retournée par la ToString méthode est le nom de l’élément, qui affiche la structure sous-jacente du fichier XML, mais n’est pas très utile dans le cas contraire. Pour créer une arborescence plus utile, vous devez définir vos propres liaisons de nœud d’arbre en remplissant la DataBindings collection.

Notes

Si vous définissez une DataBindings collection, le TreeView contrôle utilise ces valeurs au lieu des liaisons de nœud d’arbre générées automatiquement.

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

S’applique à

Voir aussi