TreeView Класс

Определение

Отображает иерархические данные, например оглавление, в древовидной структуре.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
Наследование
Атрибуты
Реализации

Примеры

Этот раздел содержит семь примеров кода:This section contains seven code examples:

  • В первом примере кода показано, как настроить кадры для второго примера кода.The first code example demonstrates how to set up the frames for the second code example.

  • Во втором примере кода демонстрируется использование декларативного синтаксиса для отображения статических данных в TreeView элементе управления.The second code example demonstrates how to use declarative syntax to display static data in the TreeView control.

  • В третьем примере кода показано, как привязать TreeView элемент управления к источнику данных XML.The third code example demonstrates how to bind the TreeView control to an XML data source.

  • Четвертый пример кода содержит образец XML-данных для третьего примера кода.The fourth code example provides sample XML data for the third code example.

  • Пятый пример кода демонстрирует использование TreeView элемента управления для навигации по сайту путем привязки его SiteMapDataSource к элементу управления.The fifth code example demonstrates how to use the TreeView control for site navigation by binding it to a SiteMapDataSource control.

  • В шестом примере кода приведен пример данных схемы узла для пятого примера кода.The sixth code example provides sample site map data for the fifth code example.

  • В седьмом примере кода показано, как заполнить узлы в TreeView элементе управления от клиента.The seventh code example demonstrates how to populate the nodes in the TreeView control from the client.

В следующем примере кода показано, как настроить кадры для следующего примера кода.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>

В следующем примере кода показано, как использовать декларативный синтаксис для отображения статических данных в TreeView элементе управления.The following code example demonstrates how to use declarative syntax to display static data in the TreeView control. Этот пример используется в наборе кадров предыдущего примера для вывода оглавления.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>

В следующем примере кода показано, как привязать TreeView элемент управления к источнику данных XML.The following code example demonstrates how to bind the TreeView control to an XML data source. Чтобы этот пример работал правильно, необходимо скопировать образец XML-данных, приведенный после этого примера кода, в файл с именем 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>

В следующем примере кода приведен пример XML-данных для предыдущего примера.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>  

В следующем примере кода показано, как использовать TreeView элемент управления для навигации по сайту, привязывая его SiteMapDataSource к элементу управления.The following code example demonstrates how to use the TreeView control for site navigation by binding it to a SiteMapDataSource control. Чтобы этот пример работал правильно, необходимо скопировать пример данных карты узла, приведенный после этого примера кода, в файл с именем 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>

В следующем примере кода приведен пример данных схемы узла для предыдущего примера кода.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>  

В следующем примере кода показано, как заполнить узлы в TreeView элементе управления от клиента.The following code example demonstrates how to populate the nodes in the TreeView control from the client. Если заполнение узла на стороне клиента включено, узлы заполняются динамически на клиенте без необходимости обратной передачи на сервер.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>

Комментарии

В этом разделе.In this topic:

ВступлениеIntroduction

TreeView Элемент управления используется для вывода иерархических данных, таких как оглавление или каталог файлов, в древовидной структуре и поддерживает следующие функции: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:

  • Привязка данных, позволяющая связывать узлы элемента управления с XML, табличными или реляционными данными.Data binding that allows the nodes of the control to be bound to XML, tabular, or relational data.

  • Навигация по сайту с помощью интеграции SiteMapDataSource с элементом управления.Site navigation through integration with the SiteMapDataSource control.

  • Текст узла, который может быть отображен как обычный текст или гиперссылки.Node text that can be displayed as either plain text or hyperlinks.

  • Программный доступ к TreeView объектной модели для создания деревьев, заполнения узлов, задания свойств и т. д. динамически.Programmatic access to the TreeView object model to create trees, populate nodes, set properties, and so on dynamically.

  • Заполнение узла на стороне клиента (в поддерживаемых браузерах).Client-side node population (on supported browsers).

  • Возможность отображать флажок рядом с каждым узлом.The ability to display a check box next to each node.

  • Настраиваемый внешний вид с помощью тем, пользовательских изображений и стилей.Customizable appearance through themes, user-defined images, and styles.

    Примечание

    Элемент управления предназначен для использования UpdatePanel внутри элемента управления trueтолько в том случае EnableClientScript , если параметр имеет значение. TreeViewThe TreeView control is designed to be used inside an UpdatePanel control only when EnableClientScript is set to true. UpdatePanelэлементы управления используются для обновления выбранных областей страницы вместо обновления всей страницы с помощью обратной передачи.UpdatePanel controls are used to update selected regions of a page instead of updating the whole page with a postback. Дополнительные сведения см. в разделе Общие сведения об элементе управления UpdatePanel и Общие сведения о частичной отрисовке страниц.For more information, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

УзлыNodes

TreeView Элемент управления состоит из узлов.The TreeView control is made up of nodes. Каждая запись в дереве называется узлом и TreeNode представляется объектом.Each entry in the tree is called a node and is represented by a TreeNode object. Типы узлов определяются следующим образом.Node types are defined as follows:

  • Узел, содержащий другие узлы, называется родительским узлом.A node that contains other nodes is called a parent node.

  • Узел, содержащийся в другом узле, называется дочерним узлом.The node that is contained by another node is called a child node.

  • Узел, не имеющий дочерних элементов, называется конечным узлом.A node that has no children is called a leaf node.

  • Узел, который не содержится ни в одном другом узле, но является предком всех остальных узлов, является корневым узлом.The node that is not contained by any other node but is the ancestor to all the other nodes is the root node.

Узел может быть одновременно родительским и дочерним, но корневой, родительский и конечный узлы являются взаимоисключающими.A node can be both a parent and a child, but root, parent, and leaf nodes are mutually exclusive. Некоторые визуальные и свойства поведения узлов определяются тем, является ли узел корневым, дочерним или конечным узлом.Several visual and behavioral properties of nodes are determined by whether a node is a root, child, or leaf node.

Хотя типичная древовидная структура имеет только один корневой узел TreeView , элемент управления позволяет добавить в древовидную структуру несколько корневых узлов.Although a typical tree structure has only one root node, the TreeView control allows you to add multiple root nodes to your tree structure. Это полезно, если нужно отобразить вхождения элементов без отображения одного корневого узла, как в списке категорий продуктов.This is useful when you want to display item listings without displaying a single root node, as in a list of product categories.

Каждый узел имеет Text свойство Value и свойство.Each node has a Text property and a Value property. Значение Text свойства отображается TreeViewв, а Value свойство используется для хранения дополнительных данных об узле, например данных, которые передаются в событие обратной передачи, связанное с узлом.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.

Узел может находиться в одном из двух режимов: режим выделения и режим навигации.A node can be in one of two modes: selection mode and navigation mode. По умолчанию узел находится в режиме выбора.By default, a node is in selection mode. Чтобы перевести узел в режим навигации, задайте NavigateUrl для свойства узла значение, отличное от пустой строки ("").To put a node into navigation mode, set the NavigateUrl property for the node to a value other than an empty string (""). Чтобы перевести узел в режим выбора, присвойте NavigateUrl свойству узла пустую строку ("").To put a node into selection mode, set the NavigateUrl property for the node to an empty string ("").

Примечание

Некоторые Интернет-браузеры имеют ограничение, которое может повлиять на TreeView производительность элемента управления.Some Internet browsers have a limitation that can affect the performance of the TreeView control. Например, Microsoft Internet Explorer 6,0 имеет ограничение по URL-адресу, равное 2067 символам, которые он отправляет.For example, Microsoft Internet Explorer 6.0 has a URL character limit of 2067 characters that it posts. Если число символов в URL-адресе узла превышает это число, расширение узла завершится ошибкой и исключение не будет создано.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.

Статические данныеStatic Data

Простейшая модель TreeView данных элемента управления — это статические данные.The simplest data model of the TreeView control is static data. Чтобы отобразить статические данные с помощью декларативного синтаксиса, сначала <Nodes> вложенные открывающие и закрывающие теги между 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. Затем создайте древовидную структуру, добавив вложенные <asp:TreeNode> элементы между открывающим и закрывающим <Nodes> тегами.Next, create the tree structure by nesting <asp:TreeNode> elements between the opening and closing <Nodes> tags. Каждый <asp:TreeNode> элемент представляет узел в дереве и сопоставляется TreeNode с объектом.Each <asp:TreeNode> element represents a node in the tree and maps to a TreeNode object. Свойства каждого узла можно задать, задав атрибуты его <asp:TreeNode> элемента.You can set the properties of each node by setting the attributes of its <asp:TreeNode> element. Чтобы создать дочерние узлы, <asp:TreeNode> вложите дополнительные элементы между открывающим <asp:TreeNode> и закрывающим тегами родительского узла.To create child nodes, nest additional <asp:TreeNode> elements between the opening and closing <asp:TreeNode> tags of the parent node.

Привязка к даннымBinding to Data

TreeView Элемент управления также может быть привязан к данным.The TreeView control can also be bound to data. Для привязки TreeView элемента управления к соответствующему типу источника данных можно использовать любой из двух методов.You can use either of two methods to bind the TreeView control to the appropriate data source type:

  • Элемент управления может использовать любой элемент управления источниками данных, IHierarchicalDataSource реализующий XmlDataSource интерфейс, например элемент управления или SiteMapDataSource элемент управления. TreeViewThe TreeView control can use any data source control that implements the IHierarchicalDataSource interface, such as an XmlDataSource control or a SiteMapDataSource control. Чтобы выполнить привязку к элементу управления источником данных DataSourceID , присвойте TreeView свойству элемента ID управления значение, равное значению элемента управления источника данных.To bind to a data source control, set the DataSourceID property of the TreeView control to the ID value of the data source control. TreeView Элемент управления автоматически привязывается к указанному элементу управления источником данных.The TreeView control automatically binds to the specified data source control. Это предпочтительный метод для привязки к данным.This is the preferred method to bind to data.

  • Элемент управления можно также привязать XmlDocument к объекту или DataSet объекту с отношениями. TreeViewThe TreeView control can also be bound to an XmlDocument object or a DataSet object with relations. Чтобы выполнить привязку к одному из этих источников данных, DataSource задайте для свойства TreeView элемента управления источник данных 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.

При привязке к источнику данных, где каждый элемент данных содержит несколько свойств (например, XML-элемент с несколькими атрибутами), узел по умолчанию отображает значение, ToString возвращаемое методом элемента данных.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. В случае XML-элемента узел отображает имя элемента, которое показывает базовую структуру дерева, но не очень полезно в противном случае.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. Можно привязать узел к определенному свойству элемента данных, указав привязки узлов дерева с помощью DataBindings коллекции.You can bind a node to a specific data item property by specifying tree node bindings using the DataBindings collection. DataBindings Коллекция содержитTreeNodeBinding объекты, определяющие связь между элементом данных и узлом, к которому он привязан.The DataBindings collection contains TreeNodeBinding objects that define the relationship between a data item and the node that it is binding to. Можно указать критерии для привязки и свойство элемента данных, которые будут отображаться в узле.You can specify the criteria for binding and the data item property to display in the node. Дополнительные сведения о привязках узла дерева см. в TreeNodeBindingразделе.For more information on tree node bindings, see TreeNodeBinding.

Важно!

Пользователь-злоумышленник может создать запрос обратного вызова и получить данные для узлов TreeView элемента управления, не отображаемых разработчиком страницы.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. Поэтому безопасность данных должна быть реализована в источнике данных.Therefore, security of the data must be implemented by the data source. Не используйте MaxDataBindDepth свойство для скрытия данных.Do not use the MaxDataBindDepth property to hide data.

Динамическое заполнение узловDynamic Node Population

Иногда невозможно статически определить древовидную структуру, так как источник данных возвращает слишком большой объем данных или поскольку отображаемые данные зависят от сведений, получаемых во время выполнения.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. По TreeView этой причине элемент управления поддерживает динамическое заполнение узла.Because of this, the TreeView control supports dynamic node population. Если для trueсвойства узла задано значение, этот узел заполняется во время выполнения при развертывании узла. PopulateOnDemandWhen the PopulateOnDemand property for a node is set to true, that node gets populated at run time when the node is expanded. Для динамического заполнения узла необходимо определить метод обработки событий, который содержит логику для заполнения узла для 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.

Браузеры, поддерживающие скрипты обратного вызова, также могут использовать преимущества заполнения узла на стороне клиента.Browsers that support callback scripts can also take advantage of client-side node population. (В том числе Internet Explorer 5,5 и более поздние версии и другие браузеры). Заполнение узла на стороне клиента позволяет TreeView элементу управления заполнять узел с помощью клиентского скрипта, когда пользователи расширяют узел, не требуя кругового обращения к серверу.(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. Дополнительные сведения о заполнении узла на стороне клиента см. PopulateNodesFromClientв разделе.For more information on client-side node population, see PopulateNodesFromClient.

Настройка пользовательского интерфейсаCustomizing the User Interface

Существует множество способов настройки внешнего вида TreeView элемента управления.There are many ways to customize the appearance of the TreeView control. Во-первых, можно указать другой стиль (например, размер и цвет шрифта) для каждого типа узла.First, you can specify a different style (such as font size and color) for each of the node types.

Если для настройки внешнего вида элемента управления используются каскадные таблицы стилей (CSS), используйте либо встроенные стили, либо отдельный CSS-файл, но не оба.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. Использование обоих встроенных стилей и отдельного CSS-файла может привести к непредвиденным результатам.Using both inline styles and a separate CSS file could cause unexpected results. Дополнительные сведения об использовании таблиц стилей с элементами управления см. в разделе элементы управления веб-сервера и стили CSS.For more information on using style sheets with controls, see Web Server Controls and CSS Styles.

В следующей таблице перечислены доступные стили узлов.The following table lists the available node styles.

Свойство стиля узлаNode style property ОписаниеDescription
HoverNodeStyle Параметры стиля для узла, когда на него наведен указатель мыши.The style settings for a node when the mouse pointer is positioned over it.
LeafNodeStyle Параметры стиля для конечных узлов.The style settings for the leaf nodes.
NodeStyle Параметры стиля по умолчанию для узла.The default style settings for a node.
ParentNodeStyle Параметры стиля для родительских узлов.The style settings for the parent nodes.
RootNodeStyle Параметры стиля для корневого узла.The style settings for the root node.
SelectedNodeStyle Параметры стиля для выбранного узла.The style settings for a selected node.

Можно также управлять стилем узлов с определенной глубиной в дереве, используя LevelStyles коллекцию.You can also control the style of nodes at specific depths within the tree by using the LevelStyles collection. Первый стиль в коллекции соответствует стилю узлов на первом уровне дерева.The first style in the collection corresponds to the style of the nodes at the first level in the tree. Второй стиль в коллекции соответствует стилю узлов на втором уровне дерева и т. д.The second style in the collection corresponds to the style of the nodes at the second level in the tree, and so on. Чаще всего это используется для создания таблицы в меню навигации в стиле содержимого, где узлы с определенной глубиной должны иметь одинаковый внешний вид независимо от того, есть ли у них дочерние узлы.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.

Примечание

Если стиль определен для определенного уровня глубины с помощью LevelStyles коллекции, этот стиль переопределяет все параметры стиля корневого, родительского и конечного узлов для узлов с этой глубиной.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.

Другим способом изменения внешнего вида элемента управления является настройка изображений, отображаемых в TreeView элементе управления.Another way to alter the appearance of the control is to customize the images that are displayed in the TreeView control. Можно указать собственный пользовательский набор изображений для различных частей элемента управления, задав свойства, показанные в следующей таблице.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.

Свойство ImageImage property ОписаниеDescription
CollapseImageUrl URL-адрес изображения, отображаемого для индикатора сворачиваемого узла.The URL to an image displayed for the collapsible node indicator. Этот образ обычно является знаком минуса (-).This image is usually a minus sign (-).
ExpandImageUrl URL-адрес изображения, отображаемого для индикатора разворачиваемого узла.The URL to an image displayed for the expandable node indicator. Это изображение обычно является знаком «плюс» (+).This image is usually a plus sign (+).
LineImagesFolder URL-адрес папки, содержащей изображения линий, используемые для подключения родительских узлов к дочерним узлам.The URL to the folder containing the line images used to connect parent nodes to child nodes. Для этого свойства также должно быть true задано значение, чтобы это свойство действовало. ShowLinesThe ShowLines property must also be set to true for this property to have an effect.
NoExpandImageUrl URL-адрес изображения, отображаемого для индикатора неразвертываемого узла.The URL to an image displayed for the non-expandable node indicator.

Примечание

Настраивать каждое свойство изображения не требуется.You do not need to customize every image property. Если свойство Image не задано явно, используется встроенный образ по умолчанию.If an image property is not explicitly set, the built-in default image is used.

TreeView Элемент управления также позволяет отображать флажок рядом с узлом.The TreeView control also allows you to display a check box next to a node. Если для TreeNodeTypes.Noneсвойства задано значение, отличное от, флажки отображаются рядом с указанными типами узлов. ShowCheckBoxesWhen the ShowCheckBoxes property is set to a value other than TreeNodeTypes.None, check boxes are displayed next to the specified node types.

Примечание

Для свойства можно задать побитовое сочетание TreeNodeTypes значений элементов перечисления. ShowCheckBoxesThe ShowCheckBoxes property can be set to a bitwise combination of the TreeNodeTypes enumeration member values.

При каждой отправке страницы на сервер CheckedNodes коллекция автоматически заполняется выбранными узлами.Each time the page is posted to the server, the CheckedNodes collection is automatically populated with the selected nodes. Когда флажки отображаются, можно использовать TreeNodeCheckChanged событие для выполнения пользовательской подпрограммы всякий раз, когда состояние флажка изменяется между отправками на сервер.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.

СобытияEvents

TreeView Элемент управления предоставляет несколько событий, по которым можно программировать.The TreeView control provides several events that you can program against. Это позволяет запускать пользовательскую подпрограммы при каждом возникновении события.This allows you to run a custom routine whenever an event occurs. В следующей таблице перечислены события, поддерживаемые TreeView элементом управления.The following table lists the events that are supported by the TreeView control.

событиеEvent ОписаниеDescription
TreeNodeCheckChanged Происходит при TreeView изменении флажков элемента управления между отправками на сервер.Occurs when the check boxes of the TreeView control change state between posts to the server.
SelectedNodeChanged Возникает при выборе узла в элементе управления TreeView.Occurs when a node is selected in the TreeView control.
TreeNodeExpanded Возникает при разворачивании узла в элементе управления TreeView.Occurs when a node is expanded in the TreeView control.
TreeNodeCollapsed Возникает при сворачивании узла в элементе управления TreeView.Occurs when a node is collapsed in the TreeView control.
TreeNodePopulate Происходит, когда узел со свойством PopulateOnDemand, имеющим значение true, разворачивается в элементе управления TreeView.Occurs when a node with its PopulateOnDemand property set to true is expanded in the TreeView control.
TreeNodeDataBound Возникает, когда элемент данных привязан к узлу в элементе управления TreeView.Occurs when a data item is bound to a node in the TreeView control.

ПрокруткаScrolling

TreeView Элемент управления не имеет встроенной прокрутки.The TreeView control does not have built-in scrolling. Чтобы добавить прокрутку, поместите TreeView элемент управления Panel в элемент управления и Panel добавьте полосы прокрутки к элементу управления.To add scrolling, place the TreeView control in a Panel control and add scrollbars to the Panel control. Дополнительные сведения см. в статье Общие сведения об элементе управления веб-сервера Panel.For more information, see Panel Web Server Control Overview.

Специальные возможностиAccessibility

Разметка, отображаемая по умолчанию для этого элемента управления, может не соответствовать стандартам специальных возможностей.The markup rendered by default for this control might not conform to accessibility standards. Дополнительные сведения о поддержке специальных возможностей для этого элемента управления см. в разделе ASP.NET Controls and Accessibility.For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

Декларативный синтаксисDeclarative 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>  

Конструкторы

TreeView()

Инициализирует новый экземпляр класса TreeView.Initializes a new instance of the TreeView class.

Свойства

AccessKey

Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Унаследовано от WebControl)
Adapter

Возвращает конкретный адаптер браузера для элемента управления.Gets the browser-specific adapter for the control.

(Унаследовано от Control)
AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Унаследовано от Control)
Attributes

Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Унаследовано от WebControl)
AutoGenerateDataBindings

Получает или задает значение, указывающее, создает ли элемент управления TreeView автоматически привязки к узлам дерева.Gets or sets a value indicating whether the TreeView control automatically generates tree node bindings.

BackColor

Получает или задает цвет фона серверного веб-элемента управления.Gets or sets the background color of the Web server control.

(Унаследовано от WebControl)
BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.Gets the control that contains this control's data binding.

(Унаследовано от Control)
BorderColor

Возвращает или задает цвет рамки элемента управления Веба.Gets or sets the border color of the Web control.

(Унаследовано от WebControl)
BorderStyle

Получает или задает стиль границы серверного веб-элемента управления.Gets or sets the border style of the Web server control.

(Унаследовано от WebControl)
BorderWidth

Возвращает или задает ширину границы серверного веб-элемента управления.Gets or sets the border width of the Web server control.

(Унаследовано от WebControl)
CheckedNodes

Возвращает коллекцию объектов TreeNode, представляющих узлы элемента управления TreeView, в которых отображается установленный флажок.Gets a collection of TreeNode objects that represent the nodes in the TreeView control that display a selected check box.

ChildControlsCreated

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.Gets a value that indicates whether the server control's child controls have been created.

(Унаследовано от Control)
ClientID

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Унаследовано от Control)
ClientIDMode

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Унаследовано от Control)
ClientIDSeparator

Возвращает значение символа разделителя, используемого в свойстве ClientID.Gets a character value representing the separator character used in the ClientID property.

(Унаследовано от Control)
CollapseImageToolTip

Получает или задает всплывающую подсказку для изображения, отображаемого для индикатора сворачиваемого узла.Gets or sets the ToolTip for the image that is displayed for the collapsible node indicator.

CollapseImageUrl

Получает или задает URL-адрес пользовательского изображения для индикатора сворачиваемого узла.Gets or sets the URL to a custom image for the collapsible node indicator.

Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.Gets the HttpContext object associated with the server control for the current Web request.

(Унаследовано от Control)
Controls

Возвращает объект ControlCollection, который представляет дочерние элементы управления для указанного элемента управления сервера в иерархии пользовательского интерфейса.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Унаследовано от Control)
ControlStyle

Возвращает или задает стиль серверного веб-элемента управления.Gets the style of the Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
ControlStyleCreated

Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Этот свойство в основном используется разработчиками элементов управления.This property is primarily used by control developers.

(Унаследовано от WebControl)
CssClass

Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Унаследовано от WebControl)
DataBindings

Возвращает коллекцию объектов TreeNodeBinding, определяющих связь между элементом данных и узлом, к которому он привязан.Gets a collection of TreeNodeBinding objects that define the relationship between a data item and the node that it is binding to.

DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Унаследовано от Control)
DataKeysContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Унаследовано от Control)
DataSource

Получает или задает объект, из которого элемент управления, присоединенный к данным, извлекает свои данные.Gets or sets the object from which the data-bound control retrieves its list of data items.

(Унаследовано от BaseDataBoundControl)
DataSourceID

Получает или задает ID элемента управления, из которого элемент управления, присоединенный к данным, извлекает свои данные.Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Унаследовано от HierarchicalDataBoundControl)
DesignMode

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.Gets a value indicating whether a control is being used on a design surface.

(Унаследовано от Control)
EnableClientScript

Получает или задает значение, указывающее, выводит ли элемент управления TreeView клиентский скрипт для обработки событий разворачивания и сворачивания.Gets or sets a value indicating whether the TreeView control renders client-side script to handle expanding and collapsing events.

Enabled

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.Gets or sets a value indicating whether the Web server control is enabled.

(Унаследовано от WebControl)
EnableTheming

Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.Gets or sets a value indicating whether themes apply to this control.

(Унаследовано от WebControl)
EnableViewState

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.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.

(Унаследовано от Control)
Events

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

(Унаследовано от Control)
ExpandDepth

Получает или задает число уровней, разворачиваемых при первом отображении элемента управления TreeView.Gets or sets the number of levels that are expanded when a TreeView control is displayed for the first time.

ExpandImageToolTip

Получает или задает всплывающую подсказку для изображения, отображаемого для индикатора разворачиваемого узла.Gets or sets the ToolTip for the image that is displayed for the expandable node indicator.

ExpandImageUrl

Получает или задает URL-адрес пользовательского изображения для индикатора разворачиваемого узла.Gets or sets the URL to a custom image for the expandable node indicator.

Font

Возвращает свойства шрифта, связанные с серверным веб-элементом управления.Gets the font properties associated with the Web server control.

(Унаследовано от WebControl)
ForeColor

Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Унаследовано от WebControl)
HasAttributes

Получает значение, определяющие наличие атрибутов у элемента управления.Gets a value indicating whether the control has attributes set.

(Унаследовано от WebControl)
HasChildViewState

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Унаследовано от Control)
Height

Получает или задает высоту серверного веб-элемента управления.Gets or sets the height of the Web server control.

(Унаследовано от WebControl)
HoverNodeStyle

Возвращает ссылку на объект TreeNodeStyle, позволяющий задать внешний вид узла при наведении на него указателя мыши.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

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.Gets or sets the programmatic identifier assigned to the server control.

(Унаследовано от Control)
IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.Gets the character used to separate control identifiers.

(Унаследовано от Control)
ImageSet

Получает или задает группу изображений, используемую для элемента управления TreeView.Gets or sets the group of images to use for the TreeView control.

Initialized

Получает значение, указывающее, был ли проинициализирован элемент управления, присоединенный к данным.Gets a value indicating whether the data-bound control has been initialized.

(Унаследовано от BaseDataBoundControl)
IsBoundUsingDataSourceID

Получает значение, указывающее, установлено ли свойство DataSourceID.Gets a value indicating whether the DataSourceID property is set.

(Унаследовано от BaseDataBoundControl)
IsChildControlStateCleared

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.Gets a value indicating whether controls contained within this control have control state.

(Унаследовано от Control)
IsDataBindingAutomatic

Получает значение, указывающее, является ли привязка данных автоматической.Gets a value that indicates whether data binding is automatic.

(Унаследовано от BaseDataBoundControl)
IsEnabled

Возвращает значение, определяющее, включен ли элемент управления.Gets a value indicating whether the control is enabled.

(Унаследовано от WebControl)
IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.Gets a value that indicates whether the server control is saving changes to its view state.

(Унаследовано от Control)
IsUsingModelBinders

При реализации в производном классе получает значение, указывающее, использует ли элемент управления связыватели модели.When implemented in a derived class, gets a value that indicates whether the control is using model binders.

(Унаследовано от BaseDataBoundControl)
IsViewStateEnabled

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.Gets a value indicating whether view state is enabled for this control.

(Унаследовано от Control)
LeafNodeStyle

Возвращает ссылку на объект TreeNodeStyle, позволяющий задать внешний вид конечных узлов.Gets a reference to the TreeNodeStyle object that allows you to set the appearance of leaf nodes.

LevelStyles

Возвращает коллекцию объектов Style, которые представляют стили узлов на отдельных уровнях дерева.Gets a collection of Style objects that represent the node styles at the individual levels of the tree.

LineImagesFolder

Получает или задает путь к папке, содержащей изображения линий, соединяющих дочерние узлы с родительскими.Gets or sets the path to a folder that contains the line images that are used to connect child nodes to parent nodes.

LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Унаследовано от Control)
MaxDataBindDepth

Получает или задает максимальное количество уровней дерева для привязки к элементу управления TreeView.Gets or sets the maximum number of tree levels to bind to the TreeView control.

NamingContainer

Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID.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.

(Унаследовано от Control)
NodeIndent

Получает или задает величину отступа (в пикселях) для дочерних узлов элемента управления TreeView.Gets or sets the indentation amount (in pixels) for the child nodes of the TreeView control.

Nodes

Возвращает коллекцию объектов TreeNode, предоставляющих корневые узлы элемента управления TreeView.Gets a collection of TreeNode objects that represents the root nodes in the TreeView control.

NodeStyle

Возвращает ссылку на объект TreeNodeStyle, позволяющий задать внешний вид по умолчанию для узлов элемента управления TreeView.Gets a reference to the TreeNodeStyle object that allows you to set the default appearance of the nodes in the TreeView control.

NodeWrap

Получает или задает значение, указывающее, переносится ли текст, если он выходит за пределы узла.Gets or sets a value indicating whether text wraps in a node when the node runs out of space.

NoExpandImageUrl

Получает или задает URL-адрес пользовательского изображения для индикатора неразворачиваемого узла.Gets or sets the URL to a custom image for the non-expandable node indicator.

Page

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.Gets a reference to the Page instance that contains the server control.

(Унаследовано от Control)
Parent

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.Gets a reference to the server control's parent control in the page control hierarchy.

(Унаследовано от Control)
ParentNodeStyle

Возвращает ссылку на объект TreeNodeStyle, позволяющий задать внешний вид родительских узлов элемента управления TreeView.Gets a reference to the TreeNodeStyle object that allows you to set the appearance of parent nodes in the TreeView control.

PathSeparator

Получает или задает символ, используемый для разграничения значений узлов, указанных свойством ValuePath.Gets or sets the character that is used to delimit the node values that are specified by the ValuePath property.

PopulateNodesFromClient

Получает или задает значение, указывающее, заполняются ли данные в узлах по запросу со стороны клиента.Gets or sets a value indicating whether node data is populated on demand from the client.

RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Унаследовано от Control)
RequiresDataBinding

Получает или задает значение, указывающее, должен ли вызываться метод DataBind().Gets or sets a value indicating whether the DataBind() method should be called.

(Унаследовано от BaseDataBoundControl)
RootNodeStyle

Возвращает ссылку на объект TreeNodeStyle, позволяющий задать внешний вид корневого узла элемента управления TreeView.Gets a reference to the TreeNodeStyle object that allows you to set the appearance of the root node in the TreeView control.

SelectedNode

Возвращает объект TreeNode, представляющий выделенный узел в элементе управления TreeView.Gets a TreeNode object that represents the selected node in the TreeView control.

SelectedNodeStyle

Возвращает объект TreeNodeStyle, управляющий внешним видом выбранного узла в элементе управления TreeView.Gets the TreeNodeStyle object that controls the appearance of the selected node in the TreeView control.

SelectedValue

Возвращает значение выбранного узла.Gets the value of the selected node.

ShowCheckBoxes

Получает или задает значение, указывающее, для каких типов узлов будет отображаться флажок в элементе управления TreeView.Gets or sets a value indicating which node types will display a check box in the TreeView control.

ShowExpandCollapse

Получает или задает значение, указывающее, отображаются ли индикаторы разворачивания узла.Gets or sets a value indicating whether expansion node indicators are displayed.

ShowLines

Получает или задает значение, указывающее, отображаются ли линии, соединяющие дочерние узлы с родительскими.Gets or sets a value indicating whether lines connecting child nodes to parent nodes are displayed.

Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.Gets information about the container that hosts the current control when rendered on a design surface.

(Унаследовано от Control)
SkinID

Возвращает или задает обложку, применяемую к элементу управления.Gets or sets the skin to apply to the control.

(Унаследовано от WebControl)
SkipLinkText

Получает или задает значение, используемое для вывода альтернативного текста для средств чтения с экрана, позволяющего пропустить содержимое элемента управления.Gets or sets a value that is used to render alternate text for screen readers to skip the content for the control.

Style

Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Унаследовано от WebControl)
SupportsDisabledAttribute

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение 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.

(Унаследовано от BaseDataBoundControl)
TabIndex

Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления.Gets or sets the tab index of the Web server control.

(Унаследовано от WebControl)
TagKey

Получает значение HtmlTextWriterTag для элемента управления TreeView.Gets the HtmlTextWriterTag value for the TreeView control.

TagName

Возвращает имя тега элемента управления.Gets the name of the control tag. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
Target

Получает или задает целевое окно или фрейм для отображения содержимого веб-страницы, связанной с узлом.Gets or sets the target window or frame in which to display the Web page content that is associated with a node.

TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.Gets or sets a reference to the template that contains this control.

(Унаследовано от Control)
TemplateSourceDirectory

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Унаследовано от Control)
ToolTip

Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Унаследовано от WebControl)
UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.Gets the unique, hierarchically qualified identifier for the server control.

(Унаследовано от Control)
ValidateRequestMode

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Унаследовано от Control)
ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.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.

(Унаследовано от Control)
ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.Gets a value that indicates whether the StateBag object is case-insensitive.

(Унаследовано от Control)
ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.Gets or sets the view-state mode of this control.

(Унаследовано от Control)
Visible

Получает или задает значение, указывающее, выводится ли элемент управления в пользовательский интерфейс на странице.Gets or sets a value indicating whether the control is rendered as UI on the page.

Width

Получает или задает ширину серверного веб-элемента управления.Gets or sets the width of the Web server control.

(Унаследовано от WebControl)

Методы

AddAttributesToRender(HtmlTextWriter)

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriter.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter control.

AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.Called after a child control is added to the Controls collection of the Control object.

(Унаследовано от Control)
AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Унаследовано от Control)
ApplyStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от WebControl)
ApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.Applies the style properties defined in the page style sheet to the control.

(Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)

Запускает трассировку во время разработки данных отрисовки.Begins design-time tracing of rendering data.

(Унаследовано от Control)
BuildProfileTree(String, Boolean)

Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Унаследовано от Control)
ClearCachedClientID()

Задает для кэшированного свойства ClientID значение null.Sets the cached ClientID value to null.

(Унаследовано от Control)
ClearChildControlState()

Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления.Deletes the control-state information for the server control's child controls.

(Унаследовано от Control)
ClearChildState()

Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state and control-state information for all the server control's child controls.

(Унаследовано от Control)
ClearChildViewState()

Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state information for all the server control's child controls.

(Унаследовано от Control)
ClearEffectiveClientIDMode()

Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Унаследовано от Control)
CollapseAll()

Закрывает каждый узел дерева.Closes every node in the tree.

ConfirmInitState()

Устанавливает исходное состояние элемента управления, присоединенного к данным.Sets the initialized state of the data-bound control.

(Унаследовано от BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод.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. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
CreateChildControls()

Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки.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.

(Унаследовано от Control)
CreateControlCollection()

Создает коллекцию для хранения дочерних элементов управления.Creates a collection to store child controls.

CreateControlStyle()

Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств.Creates the style object that is used internally by the WebControl class to implement all style related properties. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
CreateNode()

Возвращает новый экземпляр класса TreeNode.Returns a new instance of the TreeNode class. Метод CreateNode() является вспомогательным.The CreateNode() is a helper method.

DataBind()

Вызывает метод базового класса DataBind().Calls the DataBind() method of the base class.

DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Унаследовано от Control)
DataBindChildren()

Привязывает источник данных к дочерним элементам управления серверного элемента управления.Binds a data source to the server control's child controls.

(Унаследовано от Control)
Dispose()

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.Enables a server control to perform final clean up before it is released from memory.

(Унаследовано от Control)
EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.Ends design-time tracing of rendering data.

(Унаследовано от Control)
EnsureChildControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines whether the server control contains child controls. Если дочерних элементов управления нет, они будут созданы.If it does not, it creates child controls.

(Унаследовано от Control)
EnsureDataBound()

Вызывает метод DataBind(), если установлено свойство DataSourceID и элемент управления, присоединенный к данным, помечен, как требующий привязки.Calls the DataBind() method if the DataSourceID property is set and the data-bound control is marked to require binding.

(Унаследовано от BaseDataBoundControl)
EnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.Creates an identifier for controls that do not have an identifier assigned.

(Унаследовано от Control)
Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
ExpandAll()

Открывает каждый узел дерева.Opens every node in the tree.

FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.Searches the current naming container for a server control with the specified id parameter.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску.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. Эту версию метода FindControl не следует переопределять.You should not override this version of the FindControl method.

(Унаследовано от Control)
FindNode(String)

Извлекает объект TreeNode из элемента управления TreeView по указанному пути к значению.Retrieves the TreeNode object in the TreeView control at the specified value path.

Focus()

Задает фокус ввода на элемент управления.Sets input focus to a control.

(Унаследовано от Control)
GetCallbackResult()

Возвращает результат события обратного вызова, предназначенного для элемента управления.Returns the result of a callback event that targets a control.

GetData(String)

Извлекает объект HierarchicalDataSourceView, используемый элементом управления с привязкой к данным для выполнения операций с данными.Retrieves a HierarchicalDataSourceView object that the data-bound control uses to perform data operations.

(Унаследовано от HierarchicalDataBoundControl)
GetDataSource()

Извлекает объект IHierarchicalDataSource, с которым связан элемент управления с привязкой к данным, если он существует.Retrieves the IHierarchicalDataSource that the data-bound control is associated with, if any.

(Унаследовано от HierarchicalDataBoundControl)
GetDesignModeState()

Возвращает данные времени разработки для элемента управления.Gets design-time data for a control.

(Унаследовано от Control)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUniqueIDRelativeTo(Control)

Возвращает часть с префиксом свойства UniqueID указанного элемента управления.Returns the prefixed portion of the UniqueID property of the specified control.

(Унаследовано от Control)
HasControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines if the server control contains any child controls.

(Унаследовано от Control)
HasEvents()

Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления.Returns a value indicating whether events are registered for the control or any child controls.

(Унаследовано от Control)
IsLiteralContent()

Определяет наличие у серверного элемента управления только текстового содержимого.Determines if the server control holds only literal content.

(Унаследовано от Control)
LoadControlState(Object)

Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Унаследовано от Control)
LoadPostData(String, NameValueCollection)

Обрабатывает данные обратной передачи для элемента управления TreeView.Processes postback data for the TreeView control.

LoadViewState(Object)

Загружает предварительно сохраненное состояние представления элемента управления TreeView.Loads the previously saved view state of the TreeView control.

MapPathSecure(String)

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Унаследовано от Control)
MarkAsDataBound()

Задает в данных о состоянии представления состояние элемента управления, соответствующее успешной привязке к данным.Sets the state of the control in view state as successfully bound to data.

(Унаследовано от HierarchicalDataBoundControl)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MergeStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
OnBubbleEvent(Object, EventArgs)

Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Унаследовано от Control)
OnDataBinding(EventArgs)

Вызывает событие DataBinding.Raises the DataBinding event.

(Унаследовано от Control)
OnDataBound(EventArgs)

Создает событие DataBound.Raises the DataBound event.

(Унаследовано от BaseDataBoundControl)
OnDataPropertyChanged()

Вызывается при изменении одного из свойств определения базового источника данных, чтобы повторно привязать элемент управления с привязкой к данным к его данным.Called when one of the base data source identification properties is changed, to re-bind the data-bound control to its data.

(Унаследовано от HierarchicalDataBoundControl)
OnDataSourceChanged(Object, EventArgs)

Вызывается, когда экземпляр IHierarchicalDataSource, с которым работает элемент управления с привязкой к данным, вызывает событие DataSourceChanged.Called when the IHierarchicalDataSource instance that the data-bound control works with raises the DataSourceChanged event.

(Унаследовано от HierarchicalDataBoundControl)
OnInit(EventArgs)

Вызывает событие Init.Raises the Init event.

OnLoad(EventArgs)

Обрабатывает событие Load.Handles the Load event.

(Унаследовано от HierarchicalDataBoundControl)
OnPagePreLoad(Object, EventArgs)

Устанавливает исходное состояние элемента управления, привязанного к данным, перед его загрузкой.Sets the initialized state of the data-bound control before the control is loaded.

(Унаследовано от HierarchicalDataBoundControl)
OnPreRender(EventArgs)

Вызывает событие PreRender.Raises the PreRender event.

OnSelectedNodeChanged(EventArgs)

Вызывает событие SelectedNodeChanged элемента управления TreeView.Raises the SelectedNodeChanged event of the TreeView control.

OnTreeNodeCheckChanged(TreeNodeEventArgs)

Вызывает событие TreeNodeCheckChanged элемента управления TreeView.Raises the TreeNodeCheckChanged event of the TreeView control.

OnTreeNodeCollapsed(TreeNodeEventArgs)

Вызывает событие TreeNodeCollapsed элемента управления TreeView.Raises the TreeNodeCollapsed event of the TreeView control.

OnTreeNodeDataBound(TreeNodeEventArgs)

Вызывает событие TreeNodeDataBound элемента управления TreeView.Raises the TreeNodeDataBound event of the TreeView control.

OnTreeNodeExpanded(TreeNodeEventArgs)

Вызывает событие TreeNodeExpanded элемента управления TreeView.Raises the TreeNodeExpanded event of the TreeView control.

OnTreeNodePopulate(TreeNodeEventArgs)

Вызывает событие TreeNodePopulate элемента управления TreeView.Raises the TreeNodePopulate event of the TreeView control.

OnUnload(EventArgs)

Создает событие Unload.Raises the Unload event.

(Унаследовано от Control)
OpenFile(String)

Возвращает Stream, используемое для чтения файла.Gets a Stream used to read a file.

(Унаследовано от Control)
PerformDataBinding()

Создает все узлы на основе источника данных.Creates all the nodes based on the data source.

PerformSelect()

Извлекает данные из связанного источника данных.Retrieves data from the associated data source.

(Унаследовано от HierarchicalDataBoundControl)
RaiseBubbleEvent(Object, EventArgs)

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

(Унаследовано от Control)
RaiseCallbackEvent(String)

Вызывает событие обратного вызова, используя заданные аргументы.Raises the callback event using the specified arguments.

RaisePostBackEvent(String)

Позволяет элементу управления TreeView обработать событие, вызванное при передаче формы на сервер.Enables the TreeView control to process an event that is raised when a form is posted to the server. Метод RaisePostBackEvent(String) является вспомогательным для метода ICallbackEventHandler.RaiseCallbackEvent(String).The RaisePostBackEvent(String) method is a helper method for the ICallbackEventHandler.RaiseCallbackEvent(String) method.

RaisePostDataChangedEvent()

Сигнализирует элементу управления TreeView уведомить приложение ASP.NET об изменении состояния элемента управления.Signals the TreeView control to notify the ASP.NET application that the state of the control has changed.

RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.Called after a child control is removed from the Controls collection of the Control object.

(Унаследовано от Control)
Render(HtmlTextWriter)

Выполняет визуализацию элемента управления в указанный писатель HTML.Renders the control to the specified HTML writer.

(Унаследовано от WebControl)
RenderBeginTag(HtmlTextWriter)

Выводит открывающий HTML-тег элемента управления в указанное средство записи.Renders the HTML opening tag of the control to the specified writer.

RenderChildren(HtmlTextWriter)

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Унаследовано от Control)
RenderContents(HtmlTextWriter)

Отображает узлы элемента управления TreeView.Renders the nodes in the TreeView control.

RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Унаследовано от Control)
RenderEndTag(HtmlTextWriter)

Выводит закрывающий HTML-тег элемента управления в указанное средство записи.Renders the HTML closing tag of the control to the specified writer.

ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.Gets the control adapter responsible for rendering the specified control.

(Унаследовано от Control)
ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.Gets a URL that can be used by the browser.

(Унаследовано от Control)
ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.Converts a URL into one that is usable on the requesting client.

(Унаследовано от Control)
SaveControlState()

Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Унаследовано от Control)
SaveViewState()

Сохраняет состояние элемента управления TreeView.Saves the state of the TreeView control.

SetDesignModeState(IDictionary)

Задает данные времени разработки для элемента управления.Sets design-time data for a control.

(Унаследовано от Control)
SetNodeDataBound(TreeNode, Boolean)

Позволяет производному классу задавать, привязывается ли к данным указанный элемент управления TreeNode.Allows a derived class to set whether the specified TreeNode control is data-bound.

SetNodeDataItem(TreeNode, Object)

Позволяет производному классу задать элемент данных для указанного элемента управления TreeNode.Allows a derived class to set the data item for the specified TreeNode control.

SetNodeDataPath(TreeNode, String)

Позволяет производному классу задать путь к данным для указанного элемента управления TreeNode.Allows a derived class to set the data path for the specified TreeNode control.

SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.Assigns an event handler delegate to render the server control and its content into its parent control.

(Унаследовано от Control)
SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Унаследовано от Control)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TrackViewState()

Отслеживает изменения состояния представления элемента управления TreeView для сохранения их в объекте StateBag этого элемента управления.Tracks view-state changes to the TreeView control so that they can be stored in the StateBag object for the control. Объект StateBag доступен с помощью свойства ViewState.This StateBag is accessible through the ViewState property.

ValidateDataSource(Object)

Проверяет, может ли элемент управления с привязкой к данным, привязываемый к объекту, работать с этим объектом.Verifies that the object a data-bound control binds to is one it can work with.

(Унаследовано от HierarchicalDataBoundControl)

События

DataBinding

Происходит при привязке серверного элемента управления к источнику данных.Occurs when the server control binds to a data source.

(Унаследовано от Control)
DataBound

Происходит после привязки серверного элемента управления к источнику данных.Occurs after the server control binds to a data source.

(Унаследовано от BaseDataBoundControl)
Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы 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.

(Унаследовано от Control)
Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Унаследовано от Control)
Load

Происходит при загрузке серверного элемента управления в объект Page.Occurs when the server control is loaded into the Page object.

(Унаследовано от Control)
PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.Occurs after the Control object is loaded but prior to rendering.

(Унаследовано от Control)
SelectedNodeChanged

Возникает при выборе узла в элементе управления TreeView.Occurs when a node is selected in the TreeView control.

TreeNodeCheckChanged

Происходит при изменении состояния флажка в элементе управления TreeView между передачами данных на сервер.Occurs when a check box in the TreeView control changes state between posts to the server.

TreeNodeCollapsed

Возникает при сворачивании узла в элементе управления TreeView.Occurs when a node is collapsed in the TreeView control.

TreeNodeDataBound

Возникает, когда элемент данных привязан к узлу в элементе управления TreeView.Occurs when a data item is bound to a node in the TreeView control.

TreeNodeExpanded

Возникает при разворачивании узла в элементе управления TreeView.Occurs when a node is expanded in the TreeView control.

TreeNodePopulate

Происходит, когда узел со свойством PopulateOnDemand, имеющим значение true, разворачивается в элементе управления TreeView.Occurs when a node with its PopulateOnDemand property set to true is expanded in the TreeView control.

Unload

Происходит при выгрузке серверного элемента управления из памяти.Occurs when the server control is unloaded from memory.

(Унаследовано от Control)

Явные реализации интерфейса

IAttributeAccessor.GetAttribute(String)

Возвращает атрибуту веб-элемента управления указанное имя.Gets an attribute of the Web control with the specified name.

(Унаследовано от WebControl)
IAttributeAccessor.SetAttribute(String, String)

Задает атрибуту веб-элемента управления указанное имя и значение.Sets an attribute of the Web control to the specified name and value.

(Унаследовано от WebControl)
ICallbackEventHandler.GetCallbackResult()

Возвращает результат события обратного вызова, предназначенного для элемента управления.Returns the result of a callback event that targets a control.

ICallbackEventHandler.RaiseCallbackEvent(String)

Вызывает событие обратного вызова, используя заданные аргументы.Raises the callback event using the specified arguments.

IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.For a description of this member, see ControlBuilder.

(Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе GetDesignModeState().For a description of this member, see GetDesignModeState().

(Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Описание этого члена см. в разделе SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Унаследовано от Control)
IControlDesignerAccessor.UserData

Описание этого члена см. в разделе UserData.For a description of this member, see UserData.

(Унаследовано от Control)
IDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе DataBindings.For a description of this member, see DataBindings.

(Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе HasDataBindings.For a description of this member, see HasDataBindings.

(Унаследовано от Control)
IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.For a description of this member, see Expressions.

(Унаследовано от Control)
IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.For a description of this member, see HasExpressions.

(Унаследовано от Control)
IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Унаследовано от Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Обрабатывает данные обратной передачи для элемента управления TreeView.Processes postback data for the TreeView control.

IPostBackDataHandler.RaisePostDataChangedEvent()

Сигнализирует элементу управления TreeView уведомить приложение ASP.NET об изменении состояния элемента управления.Signals the TreeView control to notify the ASP.NET application that the state of the control has changed.

IPostBackEventHandler.RaisePostBackEvent(String)

Позволяет элементу управления TreeView обработать событие, вызванное при передаче формы на сервер.Enables the TreeView control to process an event that is raised when a form is posted to the server.

Методы расширения

EnablePersistedSelection(BaseDataBoundControl)

Включает возможность сохранения в элементах управления данными, поддерживающих выделение и разбиение по страницам.Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.Returns the metatable object for the containing data control.

Применяется к

Дополнительно