TreeView Class

Definition

Affiche des données hiérarchiques, telles qu’une table des matières, dans une arborescence.Displays hierarchical data, such as a table of contents, in a tree structure.

public ref class TreeView : System::Web::UI::WebControls::HierarchicalDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class TreeView : System.Web.UI.WebControls.HierarchicalDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler
type TreeView = class
    inherit HierarchicalDataBoundControl
    interface IPostBackEventHandler
    interface IPostBackDataHandler
    interface ICallbackEventHandler
Public Class TreeView
Inherits HierarchicalDataBoundControl
Implements ICallbackEventHandler, IPostBackDataHandler, IPostBackEventHandler
Inheritance
Attributes
Implements

Examples

Cette section contient sept exemples de code :This section contains seven code examples:

  • Le premier exemple de code montre comment configurer les frames pour le deuxième exemple de code.The first code example demonstrates how to set up the frames for the second code example.

  • Le deuxième exemple de code montre comment utiliser la syntaxe déclarative pour afficher des données statiques dans le contrôle TreeView.The second code example demonstrates how to use declarative syntax to display static data in the TreeView control.

  • Le troisième exemple de code montre comment lier le contrôle TreeView à une source de données XML.The third code example demonstrates how to bind the TreeView control to an XML data source.

  • Le quatrième exemple de code fournit des exemples de données XML pour le troisième exemple de code.The fourth code example provides sample XML data for the third code example.

  • Le cinquième exemple de code montre comment utiliser le contrôle TreeView pour la navigation de site en le liant à un contrôle SiteMapDataSource.The fifth code example demonstrates how to use the TreeView control for site navigation by binding it to a SiteMapDataSource control.

  • Le sixième exemple de code fournit des exemples de données de plan de site pour le cinquième exemple de code.The sixth code example provides sample site map data for the fifth code example.

  • Le septième exemple de code montre comment remplir les nœuds dans le contrôle TreeView à partir du client.The seventh code example demonstrates how to populate the nodes in the TreeView control from the client.

L’exemple de code suivant montre comment configurer les frames pour l’exemple de code suivant.The following code example demonstrates how to set up the frames for the following code example.


<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>TreeView Frameset Example</title>
</head>
         
    <frameset cols="30%, 75%">
   
        <frame title="MenuFrame" name="Menu" src="TreeViewFramecs.aspx"/>
        <frame title="ContentFrame" name="Content" src="Home.aspx"/> 
           
    </frameset>      
   
</html>


<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>TreeView Frameset Example</title>
</head>
         
    <frameset cols="30%, 75%">
   
        <frame title="MenuFrame" name="Menu" src="TreeViewFramevb.aspx"/>
        <frame title="ContentFrame" name="Content" src="Home.aspx"/> 
           
    </frameset>      
   
</html>

L’exemple de code suivant montre comment utiliser la syntaxe déclarative pour afficher des données statiques dans le contrôle TreeView.The following code example demonstrates how to use declarative syntax to display static data in the TreeView control. Cet exemple est utilisé dans le jeu de frames de l’exemple précédent pour afficher une table des matières.This example is used within the frame set of the preceding example to display a table of contents.


<%@ 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 Declarative Syntax Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Declarative Syntax Example</h3>
      
      <asp:TreeView id="SampleTreeView" 
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Target="Content" 
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1"
              Target="Content">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"
                Target="Content"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2"
              Target="Content">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </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 Declarative Syntax Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Declarative Syntax Example</h3>
      
      <asp:TreeView id="SampleTreeView" 
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Target="Content" 
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1"
              Target="Content">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"
                Target="Content"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2"
              Target="Content">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </form>
  </body>
</html>

L’exemple de code suivant montre comment lier le contrôle TreeView à une source de données XML.The following code example demonstrates how to bind the TreeView control to an XML data source. 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.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" 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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

L’exemple de code suivant fournit des exemples de données XML pour l’exemple précédent.The following code example provides sample XML data for the preceding example.

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

L’exemple de code suivant montre comment utiliser le contrôle TreeView pour la navigation de site en le liant à un contrôle SiteMapDataSource.The following code example demonstrates how to use the TreeView control for site navigation by binding it to a SiteMapDataSource control. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données de plan de site, fourni après cet exemple de code, dans un fichier nommé Web. sitemap.For this example to work correctly, you must copy the sample site map data, provided after this code example, to a file named Web.sitemap.


<%@ 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 plan de site pour l’exemple de code précédent.The following code example provides sample site map data for the preceding code example.

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

L’exemple de code suivant montre comment remplir les nœuds dans le contrôle TreeView à partir du client.The following code example demonstrates how to populate the nodes in the TreeView control from the client. Lorsque le remplissage de nœuds côté client est activé, les nœuds sont remplis de manière dynamique sur le client, sans qu’il soit nécessaire de les replacer sur le serveur.When client-side node population is enabled, nodes are populated dynamically on the client, without the need to post back to the server.


<%@ Page Language="C#" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void PopulateNode(Object sender, TreeNodeEventArgs e)
  {

    // Call the appropriate method to populate a node at a particular level.
    switch(e.Node.Depth)
    {
      case 0:
        // Populate the first-level nodes.
        PopulateCategories(e.Node);
        break;
      case 1:
        // Populate the second-level nodes.
        PopulateProducts(e.Node);
        break;
      default:
        // Do nothing.
        break;
    }
    
  }

  void PopulateCategories(TreeNode node)
  {
    
    // Query for the product categories. These are the values
    // for the second-level nodes.
    DataSet ResultSet = RunQuery("Select CategoryID, CategoryName From Categories");

    // Create the second-level nodes.
    if(ResultSet.Tables.Count > 0)
    {
    
      // Iterate through and create a new node for each row in the query results.
      // Notice that the query results are stored in the table of the DataSet.
      foreach (DataRow row in ResultSet.Tables[0].Rows)
      {
        
        // Create the new node. Notice that the CategoryId is stored in the Value property 
        // of the node. This will make querying for items in a specific category easier when
        // the third-level nodes are created. 
        TreeNode newNode = new TreeNode();
        newNode.Text = row["CategoryName"].ToString(); 
        newNode.Value = row["CategoryID"].ToString();        

        // Set the PopulateOnDemand property to true so that the child nodes can be 
        // dynamically populated.
        newNode.PopulateOnDemand = true;
        
        // Set additional properties for the node.
        newNode.SelectAction = TreeNodeSelectAction.Expand;
        
        // Add the new node to the ChildNodes collection of the parent node.
        node.ChildNodes.Add(newNode);
        
      }
      
    }
    
  }

  void PopulateProducts(TreeNode node)
  {

    // Query for the products of the current category. These are the values
    // for the third-level nodes.
    DataSet ResultSet = RunQuery("Select ProductName From Products Where CategoryID=" + node.Value);

    // Create the third-level nodes.
    if(ResultSet.Tables.Count > 0)
    {
    
      // Iterate through and create a new node for each row in the query results.
      // Notice that the query results are stored in the table of the DataSet.
      foreach (DataRow row in ResultSet.Tables[0].Rows)
      {
      
        // Create the new node.
        TreeNode NewNode = new TreeNode(row["ProductName"].ToString());
        
        // Set the PopulateOnDemand property to false, because these are leaf nodes and
        // do not need to be populated.
        NewNode.PopulateOnDemand = false;
        
        // Set additional properties for the node.
        NewNode.SelectAction = TreeNodeSelectAction.None;
        
        // Add the new node to the ChildNodes collection of the parent node.
        node.ChildNodes.Add(NewNode);
        
      }
      
    }

  }

  DataSet RunQuery(String QueryString)
  {

    // Declare the connection string. This example uses Microsoft SQL Server 
    // and connects to the Northwind sample database.
    String ConnectionString = "server=localhost;database=NorthWind;Integrated Security=SSPI"; 

    SqlConnection DBConnection = new SqlConnection(ConnectionString);
    SqlDataAdapter DBAdapter;
    DataSet ResultsDataSet = new DataSet();

    try
    {

      // Run the query and create a DataSet.
      DBAdapter = new SqlDataAdapter(QueryString, DBConnection);
      DBAdapter.Fill(ResultsDataSet);

      // Close the database connection.
      DBConnection.Close();

    }
    catch(Exception ex)
    {

      // Close the database connection if it is still open.
      if(DBConnection.State == ConnectionState.Open)
      {
        DBConnection.Close();
      }
      
      Message.Text = "Unable to connect to the database.";

    }

    return ResultsDataSet;

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView PopulateNodesFromClient Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView PopulateNodesFromClient Example</h3>
    
      <asp:TreeView id="LinksTreeView"
        Font-Names= "Arial"
        ForeColor="Blue"
        EnableClientScript="true"
        PopulateNodesFromClient="true"  
        OnTreeNodePopulate="PopulateNode"
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Text="Inventory" 
            SelectAction="Expand"  
            PopulateOnDemand="true"/>
        
        </Nodes>
        
      </asp:TreeView>
      
      <br /><br />
      
      <asp:Label id="Message" runat="server"/>

    </form>
  </body>
</html>


<%@ Page Language="VB" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub PopulateNode(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    ' Call the appropriate method to populate a node at a particular level.
    Select Case e.Node.Depth

      Case 0
        ' Populate the first-level nodes.
        PopulateCategories(e.Node)

      Case 1
        ' Populate the second-level nodes.
        PopulateProducts(e.Node)

      Case Else
        ' Do nothing.

    End Select

  End Sub

  Sub PopulateCategories(ByVal node As TreeNode)

    ' Query for the product categories. These are the values
    ' for the second-level nodes.
    Dim ResultSet As DataSet = RunQuery("Select CategoryID, CategoryName From Categories")

    ' Create the second-level nodes.
    If ResultSet.Tables.Count > 0 Then

      ' Iterate through and create a new node for each row in the query results.
      ' Notice that the query results are stored in the table of the DataSet.
      Dim row As DataRow

      For Each row In ResultSet.Tables(0).Rows

        ' Create the new node. Notice that the CategoryId is stored in the Value property 
        ' of the node. This will make querying for items in a specific category easier when
        ' the third-level nodes are created. 
        Dim newNode As TreeNode = New TreeNode()
        Newnode.Text = row("CategoryName").ToString() 
        Newnode.Value = row("CategoryID").ToString()

        ' Set the PopulateOnDemand property to true so that the child nodes can be 
        ' dynamically populated.
        newNode.PopulateOnDemand = True

        ' Set additional properties for the node.
        newNode.SelectAction = TreeNodeSelectAction.Expand

        ' Add the new node to the ChildNodes collection of the parent node.
        node.ChildNodes.Add(newNode)

      Next

    End If

  End Sub

  Sub PopulateProducts(ByVal node As TreeNode)

    ' Query for the products of the current category. These are the values
    ' for the third-level nodes.
    Dim ResultSet As DataSet = RunQuery("Select ProductName From Products Where CategoryID=" & node.Value)

    ' Create the third-level nodes.
    If ResultSet.Tables.Count > 0 Then

      ' Iterate through and create a new node for each row in the query results.
      ' Notice that the query results are stored in the table of the DataSet.
      Dim row As DataRow

      For Each row In ResultSet.Tables(0).Rows

        ' Create the new node.
        Dim NewNode As TreeNode = New TreeNode(row("ProductName").ToString())

        ' Set the PopulateOnDemand property to false, because these are leaf nodes and
        ' do not need to be populated.
        NewNode.PopulateOnDemand = False

        ' Set additional properties for the node.
        NewNode.SelectAction = TreeNodeSelectAction.None

        ' Add the new node to the ChildNodes collection of the parent node.
        node.ChildNodes.Add(NewNode)

      Next

    End If

  End Sub

  Function RunQuery(ByVal QueryString As String) As DataSet

    ' Declare the connection string. This example uses Microsoft SQL Server 
    ' and connects to the Northwind sample database.
    Dim ConnectionString As String = "server=localhost;database=NorthWind;Integrated Security=SSPI"

    Dim DBConnection As SqlConnection = New SqlConnection(ConnectionString)
    Dim DBAdapter As SqlDataAdapter
    Dim ResultsDataSet As DataSet = New DataSet

    Try

      ' Run the query and create a DataSet.
      DBAdapter = New SqlDataAdapter(QueryString, DBConnection)
      DBAdapter.Fill(ResultsDataSet)

      ' Close the database connection.
      DBConnection.Close()

    Catch ex As Exception

      ' Close the database connection if it is still open.
      If DBConnection.State = ConnectionState.Open Then

        DBConnection.Close()

      End If

      Message.Text = "Unable to connect to the database."

    End Try

    Return ResultsDataSet

  End Function

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView PopulateNodesFromClient Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView PopulateNodesFromClient Example</h3>
    
      <asp:TreeView id="LinksTreeView"
        Font-Names= "Arial"
        ForeColor="Blue"
        EnableClientScript="true"
        PopulateNodesFromClient="true"  
        OnTreeNodePopulate="PopulateNode"
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Text="Inventory" 
            SelectAction="Expand"  
            PopulateOnDemand="true"/>
        
        </Nodes>
        
      </asp:TreeView>
      
      <br /><br />
      
      <asp:Label id="Message" runat="server"/>

    </form>
  </body>
</html>

Remarks

Dans cette rubrique :In this topic:

IntroductionIntroduction

Le contrôle TreeView permet d’afficher des données hiérarchiques, telles qu’une table des matières ou un répertoire de fichiers, dans une arborescence et prend en charge les fonctionnalités suivantes :The TreeView control is used to display hierarchical data, such as a table of contents or file directory, in a tree structure and supports the following features:

  • Liaison de données qui permet aux nœuds du contrôle d’être liés à des données XML, tabulaires ou relationnelles.Data binding that allows the nodes of the control to be bound to XML, tabular, or relational data.

  • Navigation sur le site via l’intégration au contrôle SiteMapDataSource.Site navigation through integration with the SiteMapDataSource control.

  • Texte de nœud qui peut être affiché sous forme de texte brut ou de liens hypertexte.Node text that can be displayed as either plain text or hyperlinks.

  • Accès par programme au modèle objet TreeView pour créer des arborescences, remplir des nœuds, définir des propriétés, etc. dynamiquement.Programmatic access to the TreeView object model to create trees, populate nodes, set properties, and so on dynamically.

  • Remplissage de nœuds côté client (sur les navigateurs pris en charge).Client-side node population (on supported browsers).

  • La possibilité d’afficher une case à cocher en regard de chaque nœud.The ability to display a check box next to each node.

  • Apparence personnalisable via les thèmes, les images définies par l’utilisateur et les styles.Customizable appearance through themes, user-defined images, and styles.

    Note

    Le contrôle TreeView est conçu pour être utilisé dans un contrôle UpdatePanel uniquement lorsque EnableClientScript est défini sur true.The TreeView control is designed to be used inside an UpdatePanel control only when EnableClientScript is set to true. les contrôles UpdatePanel sont utilisés pour mettre à jour les régions sélectionnées d’une page au lieu de mettre à jour la page entière avec une publication (postback).UpdatePanel controls are used to update selected regions of a page instead of updating the whole page with a postback. Pour plus d’informations, consultez vue d’ensemble du contrôle UpdatePanel et vue d’ensemble du rendu de page partielle.For more information, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

NœudsNodes

Le contrôle TreeView est constitué de nœuds.The TreeView control is made up of nodes. Chaque entrée de l’arborescence est appelée un nœud et est représentée par un objet TreeNode.Each entry in the tree is called a node and is represented by a TreeNode object. Les types de nœuds sont définis comme suit :Node types are defined as follows:

  • Un nœud qui contient d’autres nœuds est appelé nœud parent.A node that contains other nodes is called a parent node.

  • Le nœud qui est contenu dans un autre nœud est appelé nœud enfant.The node that is contained by another node is called a child node.

  • Un nœud qui n’a pas d’enfant est appelé nœud terminal.A node that has no children is called a leaf node.

  • Le nœud qui n’est pas contenu dans un autre nœud, mais qui est l’ancêtre de tous les autres nœuds, est le nœud racine.The node that is not contained by any other node but is the ancestor to all the other nodes is the root node.

Un nœud peut être à la fois un parent et un enfant, mais les nœuds racine, parent et feuille s’excluent mutuellement.A node can be both a parent and a child, but root, parent, and leaf nodes are mutually exclusive. Plusieurs propriétés visuelles et comportementales des nœuds sont déterminées par le fait qu’un nœud est un nœud racine, enfant ou feuille.Several visual and behavioral properties of nodes are determined by whether a node is a root, child, or leaf node.

Bien qu’une structure d’arborescence classique ne possède qu’un seul nœud racine, le contrôle TreeView vous permet d’ajouter plusieurs nœuds racine à votre arborescence.Although a typical tree structure has only one root node, the TreeView control allows you to add multiple root nodes to your tree structure. Cela est utile lorsque vous souhaitez afficher les listes d’éléments sans afficher un seul nœud racine, comme dans une liste de catégories de produits.This is useful when you want to display item listings without displaying a single root node, as in a list of product categories.

Chaque nœud a une propriété Text et une propriété Value.Each node has a Text property and a Value property. La valeur de la propriété Text s’affiche dans le TreeView, tandis que la propriété Value est utilisée pour stocker toutes les données supplémentaires relatives au nœud, telles que les données passées à l’événement de publication (postback) associé au nœud.The value of the Text property is displayed in the TreeView, while the Value property is used to store any additional data about the node, such as data that is passed to the postback event that is associated with the node.

Un nœud peut être dans l’un des deux modes : le mode de sélection et le mode de navigation.A node can be in one of two modes: selection mode and navigation mode. Par défaut, un nœud est en mode de sélection.By default, a node is in selection mode. Pour mettre un nœud en mode de navigation, affectez à la propriété NavigateUrl du nœud une valeur autre qu’une chaîne vide ("").To put a node into navigation mode, set the NavigateUrl property for the node to a value other than an empty string (""). Pour mettre un nœud en mode de sélection, affectez à la propriété NavigateUrl du nœud une chaîne vide ("").To put a node into selection mode, set the NavigateUrl property for the node to an empty string ("").

Note

Certains navigateurs Internet ont une limitation qui peut affecter les performances du contrôle TreeView.Some Internet browsers have a limitation that can affect the performance of the TreeView control. Par exemple, Microsoft Internet Explorer 6,0 a une limite de caractères d’URL de 2067 caractères qu’il publie.For example, Microsoft Internet Explorer 6.0 has a URL character limit of 2067 characters that it posts. Si le nombre de caractères dans une URL d’un nœud est supérieur à ce nombre, le développement de ce nœud échouera et aucune exception ne sera levée.If the number of characters in a URL of a node is larger than that number, expanding that node will fail and no exception is thrown.

Données statiquesStatic Data

Le modèle de données le plus simple du contrôle TreeView est des données statiques.The simplest data model of the TreeView control is static data. Pour afficher des données statiques à l’aide de la syntaxe déclarative, commencez par imbriquer les balises d’ouverture et de fermeture <Nodes> entre les balises d’ouverture et de fermeture du contrôle TreeView.To display static data using declarative syntax, first nest opening and closing <Nodes> tags between the opening and closing tags of the TreeView control. Créez ensuite l’arborescence en imbriquant les éléments de <asp:TreeNode> entre les balises d’ouverture et de fermeture <Nodes>.Next, create the tree structure by nesting <asp:TreeNode> elements between the opening and closing <Nodes> tags. Chaque élément <asp:TreeNode> représente un nœud dans l’arborescence et est mappé à un objet TreeNode.Each <asp:TreeNode> element represents a node in the tree and maps to a TreeNode object. Vous pouvez définir les propriétés de chaque nœud en définissant les attributs de son élément <asp:TreeNode>.You can set the properties of each node by setting the attributes of its <asp:TreeNode> element. Pour créer des nœuds enfants, imbriquez des éléments de <asp:TreeNode> supplémentaires entre les balises d’ouverture et de fermeture <asp:TreeNode> du nœud parent.To create child nodes, nest additional <asp:TreeNode> elements between the opening and closing <asp:TreeNode> tags of the parent node.

Lier à des donnéesBinding to Data

Le contrôle TreeView peut également être lié aux données.The TreeView control can also be bound to data. Vous pouvez utiliser l’une ou l’autre des deux méthodes pour lier le contrôle TreeView au type de source de données approprié :You can use either of two methods to bind the TreeView control to the appropriate data source type:

  • Le contrôle TreeView peut utiliser n’importe quel contrôle de source de données qui implémente l’interface IHierarchicalDataSource, tel qu’un contrôle XmlDataSource ou un contrôle SiteMapDataSource.The TreeView control can use any data source control that implements the IHierarchicalDataSource interface, such as an XmlDataSource control or a SiteMapDataSource control. Pour effectuer une liaison à un contrôle de source de données, affectez à la propriété DataSourceID du contrôle TreeView la valeur ID du contrôle de source de données.To bind to a data source control, set the DataSourceID property of the TreeView control to the ID value of the data source control. Le contrôle TreeView est automatiquement lié au contrôle de source de données spécifié.The TreeView control automatically binds to the specified data source control. Il s’agit de la méthode recommandée pour la liaison aux données.This is the preferred method to bind to data.

  • Le contrôle TreeView peut également être lié à un objet XmlDocument ou un objet DataSet avec des relations.The TreeView control can also be bound to an XmlDocument object or a DataSet object with relations. Pour établir une liaison à l’une de ces sources de données, définissez la propriété DataSource du contrôle TreeView sur la source de données, puis appelez la méthode DataBind.To bind to one of these data sources, set the DataSource property of the TreeView control to the data source, and then call the DataBind method.

Lors de la liaison à une source de données où chaque élément de données contient plusieurs propriétés (par exemple, un élément XML avec plusieurs attributs), un nœud affiche la valeur retournée par la méthode ToString de l’élément de données par défaut.When binding to a data source where each data item contains multiple properties (such as an XML element with several attributes), a node displays the value that is returned by the ToString method of the data item, by default. Dans le cas d’un élément XML, le nœud affiche le nom de l’élément, qui affiche la structure sous-jacente de l’arborescence, mais n’est pas très utile dans le cas contraire.In the case of an XML element, the node displays the element name, which shows the underlying structure of the tree but is not very useful otherwise. Vous pouvez lier un nœud à une propriété d’élément de données spécifique en spécifiant des liaisons de nœud d’arborescence à l’aide de la collection DataBindings.You can bind a node to a specific data item property by specifying tree node bindings using the DataBindings collection. La collection DataBindings contient des objets TreeNodeBinding qui définissent la relation entre un élément de données et le nœud auquel il est lié.The DataBindings collection contains TreeNodeBinding objects that define the relationship between a data item and the node that it is binding to. Vous pouvez spécifier les critères de liaison et la propriété d’élément de données à afficher dans le nœud.You can specify the criteria for binding and the data item property to display in the node. Pour plus d’informations sur les liaisons de nœud d’arborescence, consultez TreeNodeBinding.For more information on tree node bindings, see TreeNodeBinding.

Important

Un utilisateur malveillant peut créer une demande de rappel et obtenir des données pour les nœuds du contrôle TreeView que le développeur de pages n’affiche pas.A malicious user can create a callback request and get data for the nodes of the TreeView control that the page developer is not displaying. Par conséquent, la sécurité des données doit être implémentée par la source de données.Therefore, security of the data must be implemented by the data source. N’utilisez pas la propriété MaxDataBindDepth pour masquer les données.Do not use the MaxDataBindDepth property to hide data.

Remplissage de nœud dynamiqueDynamic Node Population

Parfois, il n’est pas pratique de définir de manière statique l’arborescence, car la source de données retourne trop de données ou parce que les données à afficher dépendent des informations que vous recevez au moment de l’exécution.Sometimes, it is not practical to statically define the tree structure because the data source returns too much data or because the data to display depends on information that you get at run time. Pour cette raison, le contrôle de TreeView prend en charge le remplissage de nœuds dynamiques.Because of this, the TreeView control supports dynamic node population. Lorsque la propriété PopulateOnDemand d’un nœud est définie sur true, ce nœud est rempli au moment de l’exécution lorsque le nœud est développé.When the PopulateOnDemand property for a node is set to true, that node gets populated at run time when the node is expanded. Pour remplir un nœud dynamiquement, vous devez définir une méthode de gestion d’événements qui contient la logique de remplissage d’un nœud pour l’événement TreeNodePopulate.To populate a node dynamically, you must define an event-handling method that contains the logic to populate a node for the TreeNodePopulate event.

Les navigateurs qui prennent en charge les scripts de rappel peuvent également tirer parti du remplissage des nœuds côté client.Browsers that support callback scripts can also take advantage of client-side node population. (Cela comprend Internet Explorer 5,5 et versions ultérieures, ainsi que d’autres navigateurs.) Le remplissage de nœuds côté client permet au contrôle de TreeView de remplir un nœud à l’aide d’un script client lorsque les utilisateurs développent le nœud, sans nécessiter d’aller-retour vers le serveur.(This includes Internet Explorer 5.5 and later and some other browsers.) Client-side node population enables the TreeView control to populate a node using client script when users expand the node, without requiring a round trip to the server. Pour plus d’informations sur le remplissage de nœuds côté client, consultez PopulateNodesFromClient.For more information on client-side node population, see PopulateNodesFromClient.

Personnalisation de l’interface utilisateurCustomizing the User Interface

Il existe de nombreuses façons de personnaliser l’apparence du contrôle TreeView.There are many ways to customize the appearance of the TreeView control. Tout d’abord, vous pouvez spécifier un style différent (par exemple, la taille et la couleur de la police) pour chacun des types de nœuds.First, you can specify a different style (such as font size and color) for each of the node types.

Si vous utilisez des feuilles de style en cascade (CSS) pour personnaliser l’apparence du contrôle, utilisez des styles intralignes ou un fichier CSS distinct, mais pas les deux.If you use cascading style sheets (CSS) to customize the appearance of the control, use either inline styles or a separate CSS file, but not both. L’utilisation de styles intralignes et d’un fichier CSS distinct peut entraîner des résultats inattendus.Using both inline styles and a separate CSS file could cause unexpected results. Pour plus d’informations sur l’utilisation de feuilles de style avec des contrôles, consultez contrôles de serveur Web et styles CSS.For more information on using style sheets with controls, see Web Server Controls and CSS Styles.

Le tableau suivant répertorie les styles de nœud disponibles.The following table lists the available node styles.

Propriété de style de nœudNode style property DescriptionDescription
HoverNodeStyle Paramètres de style d’un nœud lorsque le pointeur de la souris est positionné sur lui.The style settings for a node when the mouse pointer is positioned over it.
LeafNodeStyle Paramètres de style pour les nœuds terminaux.The style settings for the leaf nodes.
NodeStyle Paramètres de style par défaut pour un nœud.The default style settings for a node.
ParentNodeStyle Paramètres de style pour les nœuds parents.The style settings for the parent nodes.
RootNodeStyle Paramètres de style du nœud racine.The style settings for the root node.
SelectedNodeStyle Paramètres de style d’un nœud sélectionné.The style settings for a selected node.

Vous pouvez également contrôler le style des nœuds à des profondeurs spécifiques dans l’arborescence à l’aide de la collection LevelStyles.You can also control the style of nodes at specific depths within the tree by using the LevelStyles collection. Le premier style de la collection correspond au style des nœuds au premier niveau de l’arborescence.The first style in the collection corresponds to the style of the nodes at the first level in the tree. Le deuxième style de la collection correspond au style des nœuds au deuxième niveau de l’arborescence, et ainsi de suite.The second style in the collection corresponds to the style of the nodes at the second level in the tree, and so on. C’est le plus souvent utilisé pour générer des menus de navigation de type table de contenu où les nœuds d’une certaine profondeur doivent avoir la même apparence, qu’ils aient ou non des nœuds enfants.This is most often used to generate table of contents-style navigation menus where nodes at a certain depth should have the same appearance, regardless of whether they have child nodes.

Note

Si un style est défini pour un certain niveau de profondeur à l’aide de la collection LevelStyles, ce style remplace tous les paramètres de style de nœud racine, parent ou feuille pour les nœuds à cette profondeur.If a style is defined for a certain depth level using the LevelStyles collection, that style overrides any root, parent, or leaf node style settings for the nodes at that depth.

Une autre façon de modifier l’apparence du contrôle consiste à personnaliser les images affichées dans le contrôle TreeView.Another way to alter the appearance of the control is to customize the images that are displayed in the TreeView control. Vous pouvez spécifier votre propre ensemble personnalisé d’images pour les différentes parties du contrôle en définissant les propriétés indiquées dans le tableau suivant.You can specify your own custom set of images for the different parts of the control by setting the properties shown in the following table.

Image, propriétéImage property DescriptionDescription
CollapseImageUrl URL vers une image affichée pour l’indicateur de nœud réductible.The URL to an image displayed for the collapsible node indicator. Cette image est généralement un signe moins (-).This image is usually a minus sign (-).
ExpandImageUrl URL vers une image affichée pour l’indicateur de nœud développable.The URL to an image displayed for the expandable node indicator. Cette image est généralement un signe plus (+).This image is usually a plus sign (+).
LineImagesFolder URL du dossier contenant les images de ligne utilisées pour connecter les nœuds parents aux nœuds enfants.The URL to the folder containing the line images used to connect parent nodes to child nodes. La propriété ShowLines doit également avoir la valeur true pour que cette propriété ait un effet.The ShowLines property must also be set to true for this property to have an effect.
NoExpandImageUrl URL vers une image affichée pour l’indicateur de nœud non développable.The URL to an image displayed for the non-expandable node indicator.

Note

Vous n’avez pas besoin de personnaliser chaque propriété d’image.You do not need to customize every image property. Si une propriété d’image n’est pas définie explicitement, l’image par défaut intégrée est utilisée.If an image property is not explicitly set, the built-in default image is used.

Le contrôle TreeView vous permet également d’afficher une case à cocher en regard d’un nœud.The TreeView control also allows you to display a check box next to a node. Lorsque la propriété ShowCheckBoxes est définie sur une valeur autre que TreeNodeTypes.None, les cases à cocher s’affichent en regard des types de nœuds spécifiés.When the ShowCheckBoxes property is set to a value other than TreeNodeTypes.None, check boxes are displayed next to the specified node types.

Note

La propriété ShowCheckBoxes peut être définie sur une combinaison d’opérations de bits des valeurs des membres de l’énumération TreeNodeTypes.The ShowCheckBoxes property can be set to a bitwise combination of the TreeNodeTypes enumeration member values.

Chaque fois que la page est publiée sur le serveur, la collection CheckedNodes est automatiquement renseignée avec les nœuds sélectionnés.Each time the page is posted to the server, the CheckedNodes collection is automatically populated with the selected nodes. Lorsque les cases à cocher sont affichées, vous pouvez utiliser l’événement TreeNodeCheckChanged pour exécuter une routine personnalisée chaque fois que l’état d’une case à cocher change entre des publications sur le serveur.When check boxes are displayed, you can use the TreeNodeCheckChanged event to run a custom routine whenever the state of a check box changes between posts to the server.

ÉvénementsEvents

Le contrôle TreeView fournit plusieurs événements que vous pouvez programmer.The TreeView control provides several events that you can program against. Cela vous permet d’exécuter une routine personnalisée à chaque fois qu’un événement se produit.This allows you to run a custom routine whenever an event occurs. Le tableau suivant répertorie les événements qui sont pris en charge par le contrôle TreeView.The following table lists the events that are supported by the TreeView control.

ÉvénementEvent DescriptionDescription
TreeNodeCheckChanged Se produit lorsque les cases à cocher du contrôle de TreeView changent d’État entre des publications sur le serveur.Occurs when the check boxes of the TreeView control change state between posts to the server.
SelectedNodeChanged Se produit lorsqu'un nœud est sélectionné dans le contrôle TreeView.Occurs when a node is selected in the TreeView control.
TreeNodeExpanded Se produit lorsqu'un nœud est développé dans le contrôle TreeView.Occurs when a node is expanded in the TreeView control.
TreeNodeCollapsed Se produit lorsqu'un nœud est réduit dans le contrôle TreeView.Occurs when a node is collapsed in the TreeView control.
TreeNodePopulate Se produit lorsqu'un nœud dont la propriété PopulateOnDemand a la valeur true est développé dans le contrôle TreeView.Occurs when a node with its PopulateOnDemand property set to true is expanded in the TreeView control.
TreeNodeDataBound Se produit lorsqu'un élément de données est lié à un nœud dans le contrôle TreeView.Occurs when a data item is bound to a node in the TreeView control.

DéfilementScrolling

Le contrôle de TreeView n’a pas de défilement intégré.The TreeView control does not have built-in scrolling. Pour ajouter le défilement, placez le contrôle TreeView dans un contrôle Panel et ajoutez des barres de défilement au contrôle Panel.To add scrolling, place the TreeView control in a Panel control and add scrollbars to the Panel control. Pour plus d’informations, consultez vue d’ensemble du contrôle serveur Web.For more information, see Panel Web Server Control Overview.

AccessibilitéAccessibility

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d’accessibilité.The markup rendered by default for this control might not conform to accessibility standards. Pour plus d’informations sur la prise en charge de l’accessibilité pour ce contrôle, consultez contrôles et accessibilité ASP.net.For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

Syntaxe déclarativeDeclarative Syntax

<asp:TreeView
    AccessKey="string"
    AutoGenerateDataBindings="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CollapseImageToolTip="string"
    CollapseImageUrl="uri"
    CssClass="string"
    DataSource="string"
    DataSourceID="string"
    EnableClientScript="True|False"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ExpandDepth="string|FullyExpand|0|1|2|3|4|5|6|7|8|9|10|11|12|13|
        14|15|16|17|18|19|20|21|22|23|24|25|26|27|28|29|30"
    ExpandImageToolTip="string"
    ExpandImageUrl="uri"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageSet="Custom|XPFileExplorer|Msdn|WindowsHelp|Simple|Simple2|
        BulletedList|BulletedList2|BulletedList3|BulletedList4|
        Arrows|News|Contacts|Inbox|Events|Faq"
    LineImagesFolder="string"
    MaxDataBindDepth="integer"
    NodeIndent="integer"
    NodeWrap="True|False"
    NoExpandImageUrl="uri"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedNodeChanged="SelectedNodeChanged event handler"
    OnTreeNodeCheckChanged="TreeNodeCheckChanged event handler"
    OnTreeNodeCollapsed="TreeNodeCollapsed event handler"
    OnTreeNodeDataBound="TreeNodeDataBound event handler"
    OnTreeNodeExpanded="TreeNodeExpanded event handler"
    OnTreeNodePopulate="TreeNodePopulate event handler"
    OnUnload="Unload event handler"
    PathSeparator="string"
    PopulateNodesFromClient="True|False"
    runat="server"
    ShowCheckBoxes="None|Root|Parent|Leaf|All"
    ShowExpandCollapse="True|False"
    ShowLines="True|False"
    SkinID="string"
    SkipLinkText="string"
    Style="string"
    TabIndex="integer"
    Target="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <DataBindings>
                <asp:TreeNodeBinding
                    DataMember="string"
                    Depth="integer"
                    FormatString="string"
                    ImageToolTip="string"
                    ImageToolTipField="string"
                    ImageUrl="uri"
                    ImageUrlField="string"
                    NavigateUrl="uri"
                    NavigateUrlField="string"
                    PopulateOnDemand="True|False"
                    SelectAction="Select|Expand|SelectExpand|None"
                    ShowCheckBox="string"
                    Target="string"
                    TargetField="string"
                    Text="string"
                    TextField="string"
                    ToolTip="string"
                    ToolTipField="string"
                    Value="string"
                    ValueField="string"
                />
        </DataBindings>
        <HoverNodeStyle />
        <LeafNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <LevelStyles>
                <asp:TreeNodeStyle
                    BackColor="color name|#dddddd"
                    BorderColor="color name|#dddddd"
                    BorderStyle="NotSet|None|Dotted|Dashed|Solid|
                        Double|Groove|Ridge|Inset|Outset"
                    BorderWidth="size"
                    ChildNodesPadding="size"
                    CssClass="string"
                    Font-Bold="True|False"
                    Font-Italic="True|False"
                    Font-Names="string"
                    Font-Overline="True|False"
                    Font-Size="string|Smaller|Larger|XX-Small|
                        X-Small|Small|Medium|Large|X-Large|XX-Large"
                    Font-Strikeout="True|False"
                    Font-Underline="True|False"
                    ForeColor="color name|#dddddd"
                    Height="size"
                    HorizontalPadding="size"
                    ImageUrl="uri"
                    NodeSpacing="size"
                    OnDisposed="Disposed event handler"
                    VerticalPadding="size"
                    Width="size"
                />
        </LevelStyles>
        <Nodes>
                <asp:TreeNode
                    Checked="True|False"
                    Expanded="string"
                    ImageToolTip="string"
                    ImageUrl="uri"
                    NavigateUrl="uri"
                    PopulateOnDemand="True|False"
                    SelectAction="Select|Expand|SelectExpand|None"
                    Selected="True|False"
                    ShowCheckBox="string"
                    Target="string"
                    Text="string"
                    ToolTip="string"
                    Value="string"
>
                </asp:TreeNode>
        </Nodes>
        <NodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <ParentNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <RootNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <SelectedNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
</asp:TreeView>

Constructors

TreeView()

Initialise une nouvelle instance de la classe TreeView.Initializes a new instance of the TreeView class.

Properties

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Inherited from WebControl)
Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Inherited from WebControl)
AutoGenerateDataBindings

Obtient ou définit une valeur indiquant si le contrôle TreeView génère automatiquement des liaisons de nœud d'arbre.Gets or sets a value indicating whether the TreeView control automatically generates tree node bindings.

BackColor

Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web.Gets or sets the background color of the Web server control.

(Inherited from WebControl)
BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.Gets the control that contains this control's data binding.

(Inherited from Control)
BorderColor

Obtient ou définit la couleur de bordure du contrôle Web.Gets or sets the border color of the Web control.

(Inherited from WebControl)
BorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.Gets or sets the border style of the Web server control.

(Inherited from WebControl)
BorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.Gets or sets the border width of the Web server control.

(Inherited from WebControl)
CheckedNodes

Obtient une collection d'objets TreeNode qui représentent les nœuds dans le contrôle TreeView qui affichent une case à cocher activée.Gets a collection of TreeNode objects that represent the nodes in the TreeView control that display a selected check box.

ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode

Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
CollapseImageToolTip

Obtient ou définit l'info-bulle pour l'image qui est affichée pour l'indicateur de nœud réductible.Gets or sets the ToolTip for the image that is displayed for the collapsible node indicator.

CollapseImageUrl

Obtient ou définit l'URL vers une image personnalisée pour l'indicateur de nœud réductible.Gets or sets the URL to a custom image for the collapsible node indicator.

Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls

Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Inherited from Control)
ControlStyle

Obtient le style d'un contrôle serveur Web.Gets the style of the Web server control. Cette propriété est principalement utilisée par des développeurs de contrôles.This property is used primarily by control developers.

(Inherited from WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Cette propriété est principalement utilisée par des développeurs de contrôles.This property is primarily used by control developers.

(Inherited from WebControl)
CssClass

Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Inherited from WebControl)
DataBindings

Obtient une collection d'objets TreeNodeBinding qui définissent la relation entre un élément de données et le nœud auquel il est lié.Gets a collection of TreeNodeBinding objects that define the relationship between a data item and the node that it is binding to.

DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DataSource

Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données.Gets or sets the object from which the data-bound control retrieves its list of data items.

(Inherited from BaseDataBoundControl)
DataSourceID

Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données.Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Inherited from HierarchicalDataBoundControl)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EnableClientScript

Obtient ou définit une valeur indiquant si le contrôle TreeView restitue le script côté client pour gérer des événements de développement et de réduction.Gets or sets a value indicating whether the TreeView control renders client-side script to handle expanding and collapsing events.

Enabled

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.Gets or sets a value indicating whether the Web server control is enabled.

(Inherited from WebControl)
EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle.Gets or sets a value indicating whether themes apply to this control.

(Inherited from WebControl)
EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle.Gets a list of event handler delegates for the control. Cette propriété est en lecture seule.This property is read-only.

(Inherited from Control)
ExpandDepth

Obtient ou définit le nombre de niveaux qui sont développés lorsqu'un contrôle TreeView est affiché pour la première fois.Gets or sets the number of levels that are expanded when a TreeView control is displayed for the first time.

ExpandImageToolTip

Obtient ou définit l'info-bulle pour l'image qui est affichée pour l'indicateur de nœud développable.Gets or sets the ToolTip for the image that is displayed for the expandable node indicator.

ExpandImageUrl

Obtient ou définit l'URL vers une image personnalisée pour l'indicateur de nœud développable.Gets or sets the URL to a custom image for the expandable node indicator.

Font

Obtient les propriétés de police associées au contrôle serveur Web.Gets the font properties associated with the Web server control.

(Inherited from WebControl)
ForeColor

Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Inherited from WebControl)
HasAttributes

Obtient une valeur indiquant si le contrôle a des attributs définis.Gets a value indicating whether the control has attributes set.

(Inherited from WebControl)
HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
Height

Obtient ou définit la hauteur du contrôle serveur Web.Gets or sets the height of the Web server control.

(Inherited from WebControl)
HoverNodeStyle

Obtient une référence à l'objet TreeNodeStyle qui vous permet de définir l'apparence d'un nœud lorsque le pointeur de la souris est positionné dessus.Gets a reference to the TreeNodeStyle object that allows you to set the appearance of a node when the mouse pointer is positioned over it.

ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.Gets the character used to separate control identifiers.

(Inherited from Control)
ImageSet

Obtient ou définit le groupe d'images à utiliser pour le contrôle TreeView.Gets or sets the group of images to use for the TreeView control.

Initialized

Obtient une valeur indiquant si le contrôle lié aux données a été initialisé.Gets a value indicating whether the data-bound control has been initialized.

(Inherited from BaseDataBoundControl)
IsBoundUsingDataSourceID

Obtient une valeur indiquant si la propriété DataSourceID est définie.Gets a value indicating whether the DataSourceID property is set.

(Inherited from BaseDataBoundControl)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsDataBindingAutomatic

Obtient une valeur qui indique si la liaison de données est automatique.Gets a value that indicates whether data binding is automatic.

(Inherited from BaseDataBoundControl)
IsEnabled

Obtient une valeur indiquant si le contrôle est activé.Gets a value indicating whether the control is enabled.

(Inherited from WebControl)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsUsingModelBinders

En cas d'implémentation dans une classe dérivée, obtient une valeur qui indique si le contrôle utilise des classeurs de modèles.When implemented in a derived class, gets a value that indicates whether the control is using model binders.

(Inherited from BaseDataBoundControl)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LeafNodeStyle

Obtient une référence à l'objet TreeNodeStyle qui vous permet de définir l'apparence des nœuds feuille.Gets a reference to the TreeNodeStyle object that allows you to set the appearance of leaf nodes.

LevelStyles

Obtient une collection d'objets Style qui représentent les styles de nœud aux niveaux de l'arborescence.Gets a collection of Style objects that represent the node styles at the individual levels of the tree.

LineImagesFolder

Obtient ou définit le chemin d'accès à un dossier qui contient les images de ligne qui sont utilisées pour relier des nœuds enfants à des nœuds parents.Gets or sets the path to a folder that contains the line images that are used to connect child nodes to parent nodes.

LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
MaxDataBindDepth

Obtient ou définit le nombre maximal de niveaux d'arborescence à lier au contrôle TreeView.Gets or sets the maximum number of tree levels to bind to the TreeView control.

NamingContainer

Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
NodeIndent

Obtient ou définit la valeur de la mise en retrait (en pixels) pour les nœuds enfants du contrôle TreeView.Gets or sets the indentation amount (in pixels) for the child nodes of the TreeView control.

Nodes

Obtient une collection d'objets TreeNode qui représentent les nœuds racine dans le contrôle TreeView.Gets a collection of TreeNode objects that represents the root nodes in the TreeView control.

NodeStyle

Obtient une référence à l'objet TreeNodeStyle qui vous permet de définir l'apparence par défaut des nœuds dans le contrôle TreeView.Gets a reference to the TreeNodeStyle object that allows you to set the default appearance of the nodes in the TreeView control.

NodeWrap

Obtient ou définit une valeur indiquant si des retours à la ligne sont appliqués au texte d'un nœud lorsque l'espace sur le nœud est insuffisant.Gets or sets a value indicating whether text wraps in a node when the node runs out of space.

NoExpandImageUrl

Obtient ou définit l'URL vers une image personnalisée pour l'indicateur de nœud non développable.Gets or sets the URL to a custom image for the non-expandable node indicator.

Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
ParentNodeStyle

Obtient une référence à l'objet TreeNodeStyle qui vous permet de définir l'apparence des nœuds parents dans le contrôle TreeView.Gets a reference to the TreeNodeStyle object that allows you to set the appearance of parent nodes in the TreeView control.

PathSeparator

Obtient ou définit le caractère qui est utilisé pour délimiter les valeurs de nœud qui sont spécifiées par la propriété ValuePath.Gets or sets the character that is used to delimit the node values that are specified by the ValuePath property.

PopulateNodesFromClient

Obtient ou définit une valeur indiquant si les données de nœud sont remplies à la demande du client.Gets or sets a value indicating whether node data is populated on demand from the client.

RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
RequiresDataBinding

Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée.Gets or sets a value indicating whether the DataBind() method should be called.

(Inherited from BaseDataBoundControl)
RootNodeStyle

Obtient une référence à l'objet TreeNodeStyle qui vous permet de définir l'apparence du nœud racine dans le contrôle TreeView.Gets a reference to the TreeNodeStyle object that allows you to set the appearance of the root node in the TreeView control.

SelectedNode

Obtient un objet TreeNode qui représente le nœud sélectionné dans le contrôle TreeView.Gets a TreeNode object that represents the selected node in the TreeView control.

SelectedNodeStyle

Obtient l'objet TreeNodeStyle qui contrôle l'apparence du nœud sélectionné dans le contrôle TreeView.Gets the TreeNodeStyle object that controls the appearance of the selected node in the TreeView control.

SelectedValue

Obtient la valeur du nœud sélectionné.Gets the value of the selected node.

ShowCheckBoxes

Obtient ou définit une valeur indiquant les types de nœuds qui afficheront une case à cocher dans le contrôle TreeView.Gets or sets a value indicating which node types will display a check box in the TreeView control.

ShowExpandCollapse

Obtient ou définit une valeur indiquant si les indicateurs de nœud de développement sont affichés.Gets or sets a value indicating whether expansion node indicators are displayed.

ShowLines

Obtient ou définit une valeur indiquant si les lignes reliant les nœuds enfants aux nœuds parents sont affichées.Gets or sets a value indicating whether lines connecting child nodes to parent nodes are displayed.

Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.Gets or sets the skin to apply to the control.

(Inherited from WebControl)
SkipLinkText

Obtient ou définit une valeur qui est utilisée pour afficher le texte de remplacement afin de permettre aux lecteurs d'écran d'ignorer le contenu du contrôle.Gets or sets a value that is used to render alternate text for screen readers to skip the content for the control.

Style

Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Inherited from WebControl)
SupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Inherited from BaseDataBoundControl)
TabIndex

Obtient ou définit l'index de tabulation du contrôle serveur Web.Gets or sets the tab index of the Web server control.

(Inherited from WebControl)
TagKey

Obtient la valeur HtmlTextWriterTag du contrôle TreeView.Gets the HtmlTextWriterTag value for the TreeView control.

TagName

Obtient le nom de la balise du contrôle.Gets the name of the control tag. Cette propriété est principalement utilisée par des développeurs de contrôles.This property is used primarily by control developers.

(Inherited from WebControl)
Target

Obtient ou définit la fenêtre ou frame cible dans lequel afficher le contenu de la page Web qui est associé à un nœud.Gets or sets the target window or frame in which to display the Web page content that is associated with a node.

TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
ToolTip

Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Inherited from WebControl)
UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible

Obtient ou définit une valeur indiquant si le contrôle est restitué sous la forme d'une interface utilisateur sur la page.Gets or sets a value indicating whether the control is rendered as UI on the page.

Width

Obtient ou définit la largeur du contrôle serveur web.Gets or sets the width of the Web server control.

(Inherited from WebControl)

Methods

AddAttributesToRender(HtmlTextWriter)

Ajoute des attributs et des styles HTML qui doivent être rendus dans le contrôle HtmlTextWriter spécifié.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter control.

AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object)

Notifie au contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is primarily used by control developers.

(Inherited from WebControl)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de la page au contrôle.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState()

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CollapseAll()

Ferme tous les nœuds de l'arborescence.Closes every node in the tree.

ConfirmInitState()

Définit l'état initialisé du contrôle lié aux données.Sets the initialized state of the data-bound control.

(Inherited from BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from WebControl)
CreateChildControls()

Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Inherited from Control)
CreateControlCollection()

Crée une collection pour stocker des contrôles enfants.Creates a collection to store child controls.

CreateControlStyle()

Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style.Creates the style object that is used internally by the WebControl class to implement all style related properties. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from WebControl)
CreateNode()

Retourne une nouvelle instance de la classe TreeNode.Returns a new instance of the TreeNode class. CreateNode() est une méthode d'assistance.The CreateNode() is a helper method.

DataBind()

Appelle la méthode DataBind() de la classe de base.Calls the DataBind() method of the base class.

DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants.Determines whether the server control contains child controls. S'il ne contient pas de contrôles enfants, il en crée.If it does not, it creates child controls.

(Inherited from Control)
EnsureDataBound()

Appelle la méthode DataBind() si la propriété DataSourceID est définie et que le contrôle lié aux données est marqué pour demander à être lié.Calls the DataBind() method if the DataSourceID property is set and the data-bound control is marked to require binding.

(Inherited from BaseDataBoundControl)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExpandAll()

Ouvre tous les nœuds de l'arborescence.Opens every node in the tree.

FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Vous ne devez pas substituer cette version de la méthode FindControl.You should not override this version of the FindControl method.

(Inherited from Control)
FindNode(String)

Récupère l'objet TreeNode dans le contrôle TreeView au niveau du chemin de valeur spécifié.Retrieves the TreeNode object in the TreeView control at the specified value path.

Focus()

Affecte le focus d'entrée à un contrôle.Sets input focus to a control.

(Inherited from Control)
GetCallbackResult()

Retourne le résultat d'un événement de rappel qui cible un contrôle.Returns the result of a callback event that targets a control.

GetData(String)

Récupère un objet HierarchicalDataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données.Retrieves a HierarchicalDataSourceView object that the data-bound control uses to perform data operations.

(Inherited from HierarchicalDataBoundControl)
GetDataSource()

Récupère le IHierarchicalDataSource auquel le contrôle lié aux données est associé, le cas échéant.Retrieves the IHierarchicalDataSource that the data-bound control is associated with, if any.

(Inherited from HierarchicalDataBoundControl)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.Gets design-time data for a control.

(Inherited from Control)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object)

Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Inherited from Control)
LoadPostData(String, NameValueCollection)

Traite les données de publication (postback) pour le contrôle TreeView.Processes postback data for the TreeView control.

LoadViewState(Object)

Charge l'état d'affichage enregistré précédemment du contrôle TreeView.Loads the previously saved view state of the TreeView control.

MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MarkAsDataBound()

Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données.Sets the state of the control in view state as successfully bound to data.

(Inherited from HierarchicalDataBoundControl)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from WebControl)
OnBubbleEvent(Object, EventArgs)

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnDataBinding(EventArgs)

Déclenche l'événement DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnDataBound(EventArgs)

Déclenche l'événement DataBound.Raises the DataBound event.

(Inherited from BaseDataBoundControl)
OnDataPropertyChanged()

Appelé lorsque l'une des propriétés d'identification de la source de données de base est modifiée, pour rétablir la liaison du contrôle lié aux données à ses données.Called when one of the base data source identification properties is changed, to re-bind the data-bound control to its data.

(Inherited from HierarchicalDataBoundControl)
OnDataSourceChanged(Object, EventArgs)

Appelé lorsque l'instance de IHierarchicalDataSource avec laquelle fonctionne le contrôle lié aux données déclenche l'événement DataSourceChanged.Called when the IHierarchicalDataSource instance that the data-bound control works with raises the DataSourceChanged event.

(Inherited from HierarchicalDataBoundControl)
OnInit(EventArgs)

Déclenche l'événement Init.Raises the Init event.

OnLoad(EventArgs)

Gère l'événement Load.Handles the Load event.

(Inherited from HierarchicalDataBoundControl)
OnPagePreLoad(Object, EventArgs)

Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé.Sets the initialized state of the data-bound control before the control is loaded.

(Inherited from HierarchicalDataBoundControl)
OnPreRender(EventArgs)

Déclenche l'événement PreRender.Raises the PreRender event.

OnSelectedNodeChanged(EventArgs)

Déclenche l'événement SelectedNodeChanged du contrôle TreeView.Raises the SelectedNodeChanged event of the TreeView control.

OnTreeNodeCheckChanged(TreeNodeEventArgs)

Déclenche l'événement TreeNodeCheckChanged du contrôle TreeView.Raises the TreeNodeCheckChanged event of the TreeView control.

OnTreeNodeCollapsed(TreeNodeEventArgs)

Déclenche l'événement TreeNodeCollapsed du contrôle TreeView.Raises the TreeNodeCollapsed event of the TreeView control.

OnTreeNodeDataBound(TreeNodeEventArgs)

Déclenche l'événement TreeNodeDataBound du contrôle TreeView.Raises the TreeNodeDataBound event of the TreeView control.

OnTreeNodeExpanded(TreeNodeEventArgs)

Déclenche l'événement TreeNodeExpanded du contrôle TreeView.Raises the TreeNodeExpanded event of the TreeView control.

OnTreeNodePopulate(TreeNodeEventArgs)

Déclenche l'événement TreeNodePopulate du contrôle TreeView.Raises the TreeNodePopulate event of the TreeView control.

OnUnload(EventArgs)

Déclenche l'événement Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.Gets a Stream used to read a file.

(Inherited from Control)
PerformDataBinding()

Crée tous les nœuds en fonction de la source de données.Creates all the nodes based on the data source.

PerformSelect()

Récupère les données de la source de données associée.Retrieves data from the associated data source.

(Inherited from HierarchicalDataBoundControl)
RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RaiseCallbackEvent(String)

Déclenche l’événement de rappel à l’aide des arguments spécifiés.Raises the callback event using the specified arguments.

RaisePostBackEvent(String)

Permet au contrôle TreeView de traiter un événement qui est déclenché lorsqu'un formulaire est publié sur le serveur.Enables the TreeView control to process an event that is raised when a form is posted to the server. La méthode RaisePostBackEvent(String) est une méthode d'assistance pour la méthode ICallbackEventHandler.RaiseCallbackEvent(String).The RaisePostBackEvent(String) method is a helper method for the ICallbackEventHandler.RaiseCallbackEvent(String) method.

RaisePostDataChangedEvent()

Indique au contrôle TreeView de notifier l'application ASP.NET de la modification de l'état du contrôle.Signals the TreeView control to notify the ASP.NET application that the state of the control has changed.

RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter)

Génère le rendu du contrôle via le writer HTML spécifié.Renders the control to the specified HTML writer.

(Inherited from WebControl)
RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié.Renders the HTML opening tag of the control to the specified writer.

RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderContents(HtmlTextWriter)

Génère le rendu des nœuds dans le contrôle TreeView.Renders the nodes in the TreeView control.

RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié.Renders the HTML closing tag of the control to the specified writer.

ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState()

Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SaveViewState()

Enregistre l'état du contrôle TreeView.Saves the state of the TreeView control.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.Sets design-time data for a control.

(Inherited from Control)
SetNodeDataBound(TreeNode, Boolean)

Permet à une classe dérivée de définir si le contrôle TreeNode spécifié est lié aux données.Allows a derived class to set whether the specified TreeNode control is data-bound.

SetNodeDataItem(TreeNode, Object)

Permet à une classe dérivée de définir l'élément de données pour le contrôle TreeNode spécifié.Allows a derived class to set the data item for the specified TreeNode control.

SetNodeDataPath(TreeNode, String)

Permet à une classe dérivée de définir le chemin d'accès aux données pour le contrôle TreeNode spécifié.Allows a derived class to set the data path for the specified TreeNode control.

SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState()

Suit les modifications d'état d'affichage apportées au contrôle TreeView afin qu'elles puissent être stockées dans l'objet StateBag du contrôle.Tracks view-state changes to the TreeView control so that they can be stored in the StateBag object for the control. Ce StateBag est accessible via la propriété ViewState.This StateBag is accessible through the ViewState property.

ValidateDataSource(Object)

Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner.Verifies that the object a data-bound control binds to is one it can work with.

(Inherited from HierarchicalDataBoundControl)

Events

DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.Occurs when the server control binds to a data source.

(Inherited from Control)
DataBound

Se produit après la liaison du contrôle serveur à une source de données.Occurs after the server control binds to a data source.

(Inherited from BaseDataBoundControl)
Disposed

Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
SelectedNodeChanged

Se produit lorsqu'un nœud est sélectionné dans le contrôle TreeView.Occurs when a node is selected in the TreeView control.

TreeNodeCheckChanged

Se produit lorsque l'état d'une case à cocher du contrôle TreeView est modifié entre des publications sur le serveur.Occurs when a check box in the TreeView control changes state between posts to the server.

TreeNodeCollapsed

Se produit lorsqu'un nœud est réduit dans le contrôle TreeView.Occurs when a node is collapsed in the TreeView control.

TreeNodeDataBound

Se produit lorsqu'un élément de données est lié à un nœud dans le contrôle TreeView.Occurs when a data item is bound to a node in the TreeView control.

TreeNodeExpanded

Se produit lorsqu'un nœud est développé dans le contrôle TreeView.Occurs when a node is expanded in the TreeView control.

TreeNodePopulate

Se produit lorsqu'un nœud dont la propriété PopulateOnDemand a la valeur true est développé dans le contrôle TreeView.Occurs when a node with its PopulateOnDemand property set to true is expanded in the TreeView control.

Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.Occurs when the server control is unloaded from memory.

(Inherited from Control)

Explicit Interface Implementations

IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.Gets an attribute of the Web control with the specified name.

(Inherited from WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.Sets an attribute of the Web control to the specified name and value.

(Inherited from WebControl)
ICallbackEventHandler.GetCallbackResult()

Retourne le résultat d'un événement de rappel qui cible un contrôle.Returns the result of a callback event that targets a control.

ICallbackEventHandler.RaiseCallbackEvent(String)

Déclenche l’événement de rappel à l’aide des arguments spécifiés.Raises the callback event using the specified arguments.

IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.For a description of this member, see UserData.

(Inherited from Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Traite les données de publication (postback) pour le contrôle TreeView.Processes postback data for the TreeView control.

IPostBackDataHandler.RaisePostDataChangedEvent()

Indique au contrôle TreeView de notifier l'application ASP.NET de la modification de l'état du contrôle.Signals the TreeView control to notify the ASP.NET application that the state of the control has changed.

IPostBackEventHandler.RaisePostBackEvent(String)

Permet au contrôle TreeView de traiter un événement qui est déclenché lorsqu'un formulaire est publié sur le serveur.Enables the TreeView control to process an event that is raised when a form is posted to the server.

Extension Methods

EnablePersistedSelection(BaseDataBoundControl)

Permet la conservation de la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination.Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.Returns the metatable object for the containing data control.

Applies to

See also