TreeView.AutoGenerateDataBindings Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece un valor que indica si el control TreeView genera automáticamente los enlaces del nodo de árbol.

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

Valor de propiedad

Boolean

true para hacer que el control TreeView genere automáticamente los enlaces del nodo de árbol; de lo contrario, false. De manera predeterminada, es true.

Ejemplos

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo deshabilitar la generación automática de enlaces de nodos de árbol estableciendo la AutoGenerateDataBindings propiedad en false. En el segundo ejemplo de código se proporcionan datos de mapa de sitio de ejemplo para el primer ejemplo de código.

En el ejemplo de código siguiente se muestra cómo deshabilitar la generación automática de enlaces de nodos de árbol estableciendo la AutoGenerateDataBindings propiedad en false. A continuación, se define una DataBindings colección para establecer la relación entre los elementos de datos de un SiteMapDataSource control y los nodos del TreeView control. Para que este ejemplo funcione correctamente, debe copiar los datos del mapa del sitio de ejemplo, proporcionados después de este ejemplo de código, en un archivo denominado 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>

En el ejemplo de código siguiente se proporcionan datos de mapa de sitio de ejemplo para el ejemplo anterior.

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

Comentarios

Los enlaces de nodo de árbol definen la relación entre un elemento de datos y el nodo al que está enlazando. Cuando se enlaza a un origen de datos donde cada elemento de datos contiene varias propiedades (por ejemplo, un elemento XML con varios atributos), el TreeView control debe saber qué propiedad de elemento de datos se va a enlazar a qué TreeNode propiedad. Si la AutoGenerateDataBindings propiedad se establece trueen , el TreeView control genera automáticamente enlaces de nodo de árbol predeterminados que establecen la Text propiedad del TreeNode objeto asociado al enlace al valor devuelto por el ToString método del elemento de datos.

Nota

Los enlaces de nodo de árbol generados automáticamente no se agregan a la DataBindings colección.

En el caso de un elemento XML, el valor devuelto por el ToString método es el nombre del elemento, que muestra la estructura subyacente del archivo XML, pero no es muy útil de lo contrario. Para crear un árbol más útil, debe definir sus propios enlaces de nodo de árbol rellenando la DataBindings colección.

Nota

Si define una DataBindings colección, el TreeView control usa esos valores en lugar de enlaces de nodo de árbol generados automáticamente.

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también