TreeView Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Affiche des données hiérarchiques, telles qu’une table des matières, dans une arborescence.
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
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type TreeView = class
inherit HierarchicalDataBoundControl
interface IPostBackEventHandler
interface IPostBackDataHandler
interface ICallbackEventHandler
Public Class TreeView
Inherits HierarchicalDataBoundControl
Implements ICallbackEventHandler, IPostBackDataHandler, IPostBackEventHandler
- Héritage
- Attributs
- Implémente
Cette section contient sept exemples de code :
Le premier exemple de code montre comment configurer les trames pour le deuxième exemple de code.
Le deuxième exemple de code montre comment utiliser la syntaxe déclarative pour afficher des données statiques dans le TreeView contrôle.
Le troisième exemple de code montre comment lier le TreeView contrôle à une source de données XML.
Le quatrième exemple de code fournit des exemples de données XML pour le troisième exemple de code.
Le cinquième exemple de code montre comment utiliser le contrôle pour la TreeView navigation sur le site en le liant à un SiteMapDataSource contrôle.
Le sixième exemple de code fournit des exemples de données de plan de site pour le cinquième exemple de code.
Le septième exemple de code montre comment remplir les nœuds dans le TreeView contrôle à partir du client.
L’exemple de code suivant montre comment configurer les trames pour l’exemple de code suivant.
<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 TreeView contrôle. Cet exemple est utilisé dans le jeu de cadres de l’exemple précédent pour afficher une table des matières.
<%@ 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 TreeView contrôle à une source de données XML. Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML fournies après cet exemple de code dans un fichier nommé Book.xml.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>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.
<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 pour la TreeView navigation sur le site en le liant à un SiteMapDataSource contrôle. Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données de plan de site, fournies après cet exemple de code, dans un fichier nommé 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.
<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 TreeView contrôle à partir du client. Lorsque la population de nœuds côté client est activée, les nœuds sont renseignés dynamiquement sur le client, sans qu’il soit nécessaire de les publier sur le serveur.
<%@ 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>
Dans cette rubrique :
Le TreeView contrôle est utilisé pour 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 :
Liaison de données qui permet aux nœuds du contrôle d’être liés à des données XML, tabulaires ou relationnelles.
Navigation du site via l’intégration avec le SiteMapDataSource contrôle.
Texte de nœud qui peut être affiché sous forme de texte brut ou de liens hypertexte.
Accès par programmation au TreeView modèle objet pour créer des arborescences, remplir des nœuds, définir des propriétés, etc. dynamiquement.
Population de nœuds côté client (sur les navigateurs pris en charge).
Possibilité d’afficher une case à cocher en regard de chaque nœud.
Apparence personnalisable via des thèmes, des images définies par l’utilisateur et des styles.
Notes
Le TreeView contrôle est conçu pour être utilisé à l’intérieur d’un UpdatePanel contrôle uniquement lorsque EnableClientScript est défini sur
true
. UpdatePanel les contrôles sont utilisés pour mettre à jour les régions sélectionnées d’une page au lieu de mettre à jour l’ensemble de la page avec une publication. Pour plus d’informations, consultez Vue d’ensemble du contrôle UpdatePanel et Vue d’ensemble du rendu de page partielle.
Le TreeView contrôle est composé de nœuds. Chaque entrée de l’arborescence est appelée nœud et est représentée par un TreeNode objet. Les types de nœuds sont définis comme suit :
Un nœud qui contient d’autres nœuds est appelé nœud parent.
Le nœud contenu par un autre nœud est appelé nœud enfant.
Un nœud qui n’a pas d’enfants est appelé nœud feuille.
Le nœud qui n’est contenu par aucun autre nœud, mais qui est l’ancêtre de tous les autres nœuds est le nœud racine.
Un nœud peut être à la fois un parent et un enfant, mais les nœuds racine, parent et feuille s’excluent mutuellement. Plusieurs propriétés visuelles et comportementales des nœuds sont déterminées par si un nœud est un nœud racine, enfant ou feuille.
Bien qu’une arborescence classique n’ait qu’un seul nœud racine, le TreeView contrôle vous permet d’ajouter plusieurs nœuds racines à votre arborescence. Cela est utile lorsque vous souhaitez afficher des listes d’éléments sans afficher un seul nœud racine, comme dans une liste de catégories de produits.
Chaque nœud a une Text propriété et une Value propriété. La valeur de la Text propriété s’affiche dans , TreeViewtandis que la Value propriété est utilisée pour stocker toutes les données supplémentaires sur le nœud, telles que les données transmises à l’événement de publication associé au nœud.
Un nœud peut être dans l’un des deux modes suivants : mode sélection et mode de navigation. Par défaut, un nœud est en mode sélection. Pour placer un nœud en mode de navigation, définissez la NavigateUrl propriété du nœud sur une valeur autre qu’une chaîne vide (« »). Pour placer un nœud en mode sélection, définissez la NavigateUrl propriété du nœud sur une chaîne vide (« »).
Notes
Certains navigateurs Internet ont une limitation qui peut affecter les performances du TreeView contrôle. Par exemple, Microsoft Internet Explorer 6.0 a une limite de caractères d’URL de 2067 caractères qu’il publie. 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 échoue et aucune exception n’est levée.
Le modèle de données le plus simple du contrôle est les TreeView données statiques. Pour afficher des données statiques à l’aide de la syntaxe déclarative, imbriquez d’abord les balises d’ouverture et de fermeture <Nodes>
entre les balises d’ouverture et de fermeture du TreeView contrôle. Ensuite, créez l’arborescence en imbrication d’éléments <asp:TreeNode>
entre les balises d’ouverture et de fermeture <Nodes>
. Chaque <asp:TreeNode>
élément représente un nœud dans l’arborescence et est mappé à un TreeNode objet. Vous pouvez définir les propriétés de chaque nœud en définissant les attributs de son <asp:TreeNode>
élément. Pour créer des nœuds enfants, imbriquez des éléments supplémentaires <asp:TreeNode>
entre les balises d’ouverture et de fermeture <asp:TreeNode>
du nœud parent.
Le TreeView contrôle peut également être lié à des données. Vous pouvez utiliser l’une des deux méthodes pour lier le TreeView contrôle au type de source de données approprié :
Le TreeView contrôle peut utiliser n’importe quel contrôle de source de données qui implémente l’interface IHierarchicalDataSource , tel qu’un XmlDataSource contrôle ou un SiteMapDataSource contrôle. Pour établir une liaison à un contrôle de source de données, définissez la DataSourceID propriété du TreeView contrôle sur la ID valeur du contrôle de source de données. Le TreeView contrôle se lie automatiquement au contrôle de source de données spécifié. Il s’agit de la méthode recommandée pour lier des données.
Le TreeView contrôle peut également être lié à un XmlDocument objet ou à un objet avec des DataSet relations. Pour établir une liaison à l’une de ces sources de données, définissez la DataSource propriété du TreeView contrôle sur la source de données, puis appelez la DataBind méthode .
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 ToString
méthode de l’élément de données, par défaut. Dans le cas d’un élément XML, le nœud affiche le nom de l’élément, qui montre la structure sous-jacente de l’arborescence, mais qui n’est pas très utile dans le cas contraire. 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 DataBindings collection. La DataBindings collection contient des TreeNodeBinding
objets qui définissent la relation entre un élément de données et le nœud auquel elle est lié. Vous pouvez spécifier les critères de liaison et la propriété d’élément de données à afficher dans le nœud. Pour plus d’informations sur les liaisons de nœuds d’arborescence, consultez TreeNodeBinding.
Important
Un utilisateur malveillant peut créer une demande de rappel et obtenir des données pour les nœuds du TreeView contrôle que le développeur de pages n’affiche pas. Par conséquent, la sécurité des données doit être implémentée par la source de données. N’utilisez pas la MaxDataBindDepth propriété pour masquer des données.
Parfois, il n’est pas pratique de définir statiquement 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 obtenez au moment de l’exécution. Pour cette raison, le contrôle prend en charge la TreeView population de nœuds dynamiques. Lorsque la PopulateOnDemand propriété 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é. Pour remplir un nœud dynamiquement, vous devez définir une méthode de gestion des événements qui contient la logique de remplissage d’un nœud pour l’événement TreeNodePopulate .
Les navigateurs qui prennent en charge les scripts de rappel peuvent également tirer parti de la population de nœuds côté client. (Cela inclut Internet Explorer 5.5 et versions ultérieures et d’autres navigateurs.) La population de nœuds côté client permet au contrôle de remplir un nœud à l’aide TreeView d’un script client lorsque les utilisateurs développent le nœud, sans nécessiter d’aller-retour vers le serveur. Pour plus d’informations sur la population de nœuds côté client, consultez PopulateNodesFromClient.
Il existe de nombreuses façons de personnaliser l’apparence du TreeView contrôle. Tout d’abord, vous pouvez spécifier un style différent (par exemple, la taille et la couleur de police) pour chaque type de nœud.
Si vous utilisez des feuilles de style en cascade (CSS) pour personnaliser l’apparence du contrôle, utilisez des styles inline ou un fichier CSS distinct, mais pas les deux. L’utilisation de styles inline et d’un fichier CSS distinct peut entraîner des résultats inattendus. Pour plus d’informations sur l’utilisation de feuilles de style avec des contrôles, consultez Contrôles de serveur web et styles CSS.
Le tableau suivant répertorie les styles de nœud disponibles.
Propriété de style de nœud | Description |
---|---|
HoverNodeStyle | Paramètres de style d’un nœud lorsque le pointeur de la souris est positionné sur celui-ci. |
LeafNodeStyle | Paramètres de style pour les nœuds feuilles. |
NodeStyle | Paramètres de style par défaut d’un nœud. |
ParentNodeStyle | Paramètres de style pour les nœuds parents. |
RootNodeStyle | Paramètres de style pour le nœud racine. |
SelectedNodeStyle | Paramètres de style pour un nœud sélectionné. |
Vous pouvez également contrôler le style des nœuds à des profondeurs spécifiques dans l’arborescence à l’aide de la LevelStyles collection. Le premier style de la collection correspond au style des nœuds au premier niveau de l’arborescence. Le deuxième style de la collection correspond au style des nœuds au deuxième niveau de l’arborescence, et ainsi de suite. Cela est le plus souvent utilisé pour générer des menus de navigation de style table des matières où les nœuds à une certaine profondeur doivent avoir la même apparence, qu’ils aient ou non des nœuds enfants.
Notes
Si un style est défini pour un certain niveau de profondeur à l’aide de la LevelStyles collection, ce style remplace tous les paramètres de style racine, parent ou nœud feuille pour les nœuds à cette profondeur.
Une autre façon de modifier l’apparence du contrôle consiste à personnaliser les images affichées dans le TreeView contrôle. Vous pouvez spécifier votre propre jeu d’images personnalisé pour les différentes parties du contrôle en définissant les propriétés indiquées dans le tableau suivant.
Propriété Image | Description |
---|---|
CollapseImageUrl | URL d’une image affichée pour l’indicateur de nœud réductible. Cette image est généralement un signe moins (-). |
ExpandImageUrl | URL d’une image affichée pour l’indicateur de nœud extensible. Cette image est généralement un signe plus (+). |
LineImagesFolder | URL du dossier contenant les images de ligne utilisées pour connecter les nœuds parents aux nœuds enfants. La ShowLines propriété doit également être définie sur true pour que cette propriété ait un effet. |
NoExpandImageUrl | URL d’une image affichée pour l’indicateur de nœud non extensible. |
Notes
Vous n’avez pas besoin de personnaliser chaque propriété d’image. Si une propriété d’image n’est pas définie explicitement, l’image par défaut intégrée est utilisée.
Le TreeView contrôle vous permet également d’afficher une case à cocher en regard d’un nœud. Lorsque la ShowCheckBoxes propriété 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.
Notes
La ShowCheckBoxes propriété peut être définie sur une combinaison de bits des valeurs membres de l’énumération TreeNodeTypes .
Chaque fois que la page est publiée sur le serveur, la CheckedNodes collection est automatiquement remplie avec les nœuds sélectionnés. Lorsque des 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 les publications sur le serveur.
Le TreeView contrôle fournit plusieurs événements sur lesquels vous pouvez programmer. Cela vous permet d’exécuter une routine personnalisée chaque fois qu’un événement se produit. Le tableau suivant répertorie les événements pris en charge par le TreeView contrôle.
Événement | Description |
---|---|
TreeNodeCheckChanged | Se produit lorsque les cases à cocher du contrôle changent d’état TreeView entre les publications sur le serveur. |
SelectedNodeChanged | Se produit lorsqu'un nœud est sélectionné dans le contrôle TreeView. |
TreeNodeExpanded | Se produit lorsqu'un nœud est développé dans le contrôle TreeView. |
TreeNodeCollapsed | Se produit lorsqu'un nœud est réduit dans le contrôle TreeView. |
TreeNodePopulate | Se produit lorsqu'un nœud dont la propriété PopulateOnDemand a la valeur true est développé dans le contrôle TreeView. |
TreeNodeDataBound | Se produit lorsqu'un élément de données est lié à un nœud dans le contrôle TreeView. |
Le TreeView contrôle n’a pas de défilement intégré. Pour ajouter le défilement, placez le TreeView contrôle dans un Panel contrôle et ajoutez des barres de défilement au Panel contrôle. Pour plus d’informations, consultez Vue d’ensemble du contrôle de serveur web panel.
Le balisage rendu par défaut pour ce contrôle peut ne pas être conforme aux normes d’accessibilité. Pour plus d’informations sur la prise en charge de l’accessibilité pour ce contrôle, consultez ASP.NET Contrôles et accessibilité.
<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>
Tree |
Initialise une nouvelle instance de la classe TreeView. |
Access |
Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl) |
Adapter |
Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
App |
Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control) |
Attributes |
Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl) |
Auto |
Obtient ou définit une valeur indiquant si le contrôle TreeView génère automatiquement des liaisons de nœud d'arbre. |
Back |
Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl) |
Binding |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
Border |
Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl) |
Border |
Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl) |
Border |
Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl) |
Checked |
Obtient une collection d'objets TreeNode qui représentent les nœuds dans le contrôle TreeView qui affichent une case à cocher activée. |
Child |
Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
ClientID |
Obtient l’ID de contrôle du balisage HTML généré par ASP.NET. (Hérité de Control) |
Client |
Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control) |
Client |
Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control) |
Collapse |
Obtient ou définit l'info-bulle pour l'image qui est affichée pour l'indicateur de nœud réductible. |
Collapse |
Obtient ou définit l'URL vers une image personnalisée pour l'indicateur de nœud réductible. |
Context |
Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de 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. (Hérité de Control) |
Control |
Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
Control |
Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
Css |
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. (Hérité de WebControl) |
Data |
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é. |
Data |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control) |
Data |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control) |
Data |
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. (Hérité de BaseDataBoundControl) |
Data |
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. (Hérité de HierarchicalDataBoundControl) |
Design |
Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control) |
Enable |
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. |
Enabled |
Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl) |
Enable |
Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl) |
Enable |
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. (Hérité de Control) |
Events |
Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
Expand |
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. |
Expand |
Obtient ou définit l'info-bulle pour l'image qui est affichée pour l'indicateur de nœud développable. |
Expand |
Obtient ou définit l'URL vers une image personnalisée pour l'indicateur de nœud développable. |
Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
Fore |
Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl) |
Has |
Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl) |
Has |
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. (Hérité de Control) |
Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
Hover |
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. |
ID |
Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control) |
Id |
Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control) |
Image |
Obtient ou définit le groupe d'images à utiliser pour le contrôle TreeView. |
Initialized |
Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl) |
Is |
Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl) |
Is |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control) |
Is |
Obtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl) |
Is |
Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl) |
Is |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control) |
Is |
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. (Hérité de BaseDataBoundControl) |
Is |
Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control) |
Leaf |
Obtient une référence à l'objet TreeNodeStyle qui vous permet de définir l'apparence des nœuds feuille. |
Level |
Obtient une collection d'objets Style qui représentent les styles de nœud aux niveaux de l'arborescence. |
Line |
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. |
Load |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control) |
Max |
Obtient ou définit le nombre maximal de niveaux d'arborescence à lier au contrôle TreeView. |
Naming |
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. (Hérité de Control) |
Node |
Obtient ou définit la valeur de la mise en retrait (en pixels) pour les nœuds enfants du contrôle TreeView. |
Nodes |
Obtient une collection d'objets TreeNode qui représentent les nœuds racine dans le contrôle TreeView. |
Node |
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. |
Node |
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. |
No |
Obtient ou définit l'URL vers une image personnalisée pour l'indicateur de nœud non développable. |
Page |
Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de 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. (Hérité de Control) |
Parent |
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. |
Path |
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. |
Populate |
Obtient ou définit une valeur indiquant si les données de nœud sont remplies à la demande du client. |
Rendering |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control) |
Requires |
Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée. (Hérité de BaseDataBoundControl) |
Root |
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. |
Selected |
Obtient un objet TreeNode qui représente le nœud sélectionné dans le contrôle TreeView. |
Selected |
Obtient l'objet TreeNodeStyle qui contrôle l'apparence du nœud sélectionné dans le contrôle TreeView. |
Selected |
Obtient la valeur du nœud sélectionné. |
Show |
Obtient ou définit une valeur indiquant les types de nœuds qui afficheront une case à cocher dans le contrôle TreeView. |
Show |
Obtient ou définit une valeur indiquant si les indicateurs de nœud de développement sont affichés. |
Show |
Obtient ou définit une valeur indiquant si les lignes reliant les nœuds enfants aux nœuds parents sont affichées. |
Site |
Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control) |
SkinID |
Obtient ou définit l’apparence à appliquer au contrôle. (Hérité de WebControl) |
Skip |
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. |
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. (Hérité de WebControl) |
Supports |
Obtient une valeur qui indique si le contrôle doit définir l'attribut |
Tab |
Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
Tag |
Obtient la valeur HtmlTextWriterTag du contrôle TreeView. |
Tag |
Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de 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. |
Template |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
Template |
Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control) |
Tool |
Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl) |
UniqueID |
Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control) |
Validate |
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. (Hérité de Control) |
View |
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. (Hérité de Control) |
View |
Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control) |
View |
Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de 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. |
Width |
Obtient ou définit la largeur du contrôle serveur web. (Hérité de WebControl) |
Add |
Ajoute des attributs et des styles HTML qui doivent être rendus dans le contrôle HtmlTextWriter spécifié. |
Added |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control) |
Add |
Avertit le 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. (Hérité de Control) |
Apply |
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. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
Apply |
Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control) |
Begin |
Commence le traçage au moment du design des données de rendu. (Hérité de Control) |
Build |
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. (Hérité de Control) |
Clear |
Affecte à la valeur ClientID mise en cache la valeur |
Clear |
Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control) |
Clear |
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. (Hérité de Control) |
Clear |
Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
Clear |
Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control) |
Collapse |
Ferme tous les nœuds de l'arborescence. |
Confirm |
Définit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl) |
Copy |
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. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
Create |
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. (Hérité de Control) |
Create |
Crée une collection pour stocker des contrôles enfants. |
Create |
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. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
Create |
Retourne une nouvelle instance de la classe TreeNode. CreateNode() est une méthode d'assistance. |
Data |
Appelle la méthode DataBind() de la classe de base. |
Data |
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. (Hérité de Control) |
Data |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
Dispose() |
Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control) |
End |
Met fin au traçage au moment du design des données de rendu. (Hérité de Control) |
Ensure |
Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control) |
Ensure |
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é. (Hérité de BaseDataBoundControl) |
EnsureID() |
Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
Expand |
Ouvre tous les nœuds de l'arborescence. |
Find |
Recherche un contrôle serveur possédant le paramètre |
Find |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
Find |
Récupère l'objet TreeNode dans le contrôle TreeView au niveau du chemin de valeur spécifié. |
Focus() |
Affecte le focus d'entrée à un contrôle. (Hérité de Control) |
Get |
Retourne le résultat d'un événement de rappel qui cible un contrôle. |
Get |
Récupère un objet HierarchicalDataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données. (Hérité de HierarchicalDataBoundControl) |
Get |
Récupère le IHierarchicalDataSource auquel le contrôle lié aux données est associé, le cas échéant. (Hérité de HierarchicalDataBoundControl) |
Get |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
Get |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
Get |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
Get |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
Get |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
Get |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Get |
Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control) |
Has |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
Has |
Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control) |
Is |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
Load |
Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState(). (Hérité de Control) |
Load |
Traite les données de publication (postback) pour le contrôle TreeView. |
Load |
Charge l'état d'affichage enregistré précédemment du contrôle TreeView. |
Map |
Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control) |
Mark |
Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données. (Hérité de HierarchicalDataBoundControl) |
Memberwise |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
Merge |
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. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
On |
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. (Hérité de Control) |
On |
Déclenche l’événement DataBinding. (Hérité de Control) |
On |
Déclenche l’événement DataBound. (Hérité de BaseDataBoundControl) |
On |
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. (Hérité de HierarchicalDataBoundControl) |
On |
Appelé lorsque l'instance de IHierarchicalDataSource avec laquelle fonctionne le contrôle lié aux données déclenche l'événement DataSourceChanged. (Hérité de HierarchicalDataBoundControl) |
On |
Déclenche l’événement Init. |
On |
Gère l'événement Load. (Hérité de HierarchicalDataBoundControl) |
On |
Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. (Hérité de HierarchicalDataBoundControl) |
On |
Déclenche l’événement PreRender. |
On |
Déclenche l'événement SelectedNodeChanged du contrôle TreeView. |
On |
Déclenche l'événement TreeNodeCheckChanged du contrôle TreeView. |
On |
Déclenche l'événement TreeNodeCollapsed du contrôle TreeView. |
On |
Déclenche l'événement TreeNodeDataBound du contrôle TreeView. |
On |
Déclenche l'événement TreeNodeExpanded du contrôle TreeView. |
On |
Déclenche l'événement TreeNodePopulate du contrôle TreeView. |
On |
Déclenche l’événement Unload. (Hérité de Control) |
Open |
Obtient un Stream utilisé pour lire un fichier. (Hérité de Control) |
Perform |
Crée tous les nœuds en fonction de la source de données. |
Perform |
Récupère les données de la source de données associée. (Hérité de HierarchicalDataBoundControl) |
Raise |
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control) |
Raise |
Déclenche l’événement de rappel à l’aide des arguments spécifiés. |
Raise |
Permet au contrôle TreeView de traiter un événement qui est déclenché lorsqu'un formulaire est publié sur le serveur. La méthode RaisePostBackEvent(String) est une méthode d'assistance pour la méthode ICallbackEventHandler.RaiseCallbackEvent(String). |
Raise |
Indique au contrôle TreeView de notifier l'application ASP.NET de la modification de l'état du contrôle. |
Removed |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
Render(Html |
Génère le rendu du contrôle via le writer HTML spécifié. (Hérité de WebControl) |
Render |
Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. |
Render |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
Render |
Génère le rendu des nœuds dans le contrôle TreeView. |
Render |
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é. (Hérité de Control) |
Render |
Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control) |
Render |
Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. |
Resolve |
Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control) |
Resolve |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
Resolve |
Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control) |
Save |
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. (Hérité de Control) |
Save |
Enregistre l'état du contrôle TreeView. |
Set |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
Set |
Permet à une classe dérivée de définir si le contrôle TreeNode spécifié est lié aux données. |
Set |
Permet à une classe dérivée de définir l'élément de données pour le contrôle TreeNode spécifié. |
Set |
Permet à une classe dérivée de définir le chemin d'accès aux données pour le contrôle TreeNode spécifié. |
Set |
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. (Hérité de Control) |
Set |
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. (Hérité de Control) |
Set |
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. (Hérité de Control) |
To |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Track |
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. Ce StateBag est accessible via la propriété ViewState. |
Validate |
Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner. (Hérité de HierarchicalDataBoundControl) |
Data |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
Data |
Se produit après la liaison du contrôle serveur à une source de données. (Hérité de 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. (Hérité de Control) |
Init |
Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control) |
Load |
Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control) |
Pre |
Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control) |
Selected |
Se produit lorsqu'un nœud est sélectionné dans le contrôle TreeView. |
Tree |
Se produit lorsque l'état d'une case à cocher du contrôle TreeView est modifié entre des publications sur le serveur. |
Tree |
Se produit lorsqu'un nœud est réduit dans le contrôle TreeView. |
Tree |
Se produit lorsqu'un élément de données est lié à un nœud dans le contrôle TreeView. |
Tree |
Se produit lorsqu'un nœud est développé dans le contrôle TreeView. |
Tree |
Se produit lorsqu'un nœud dont la propriété PopulateOnDemand a la valeur |
Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
IAttribute |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
IAttribute |
Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl) |
ICallback |
Retourne le résultat d'un événement de rappel qui cible un contrôle. |
ICallback |
Déclenche l’événement de rappel à l’aide des arguments spécifiés. |
IControl |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
IControl |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
IControl |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
IControl |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
IControl |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
IData |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
IData |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
IExpressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
IExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
IParser |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
IPost |
Traite les données de publication (postback) pour le contrôle TreeView. |
IPost |
Indique au contrôle TreeView de notifier l'application ASP.NET de la modification de l'état du contrôle. |
IPost |
Permet au contrôle TreeView de traiter un événement qui est déclenché lorsqu'un formulaire est publié sur le serveur. |
Enable |
Obsolète.
Permet la conservation de la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination. |
Find |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
Find |
Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
Find |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
Produit | Versions |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :