TreeView.EnableClientScript 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 representa script de cliente para controlar los eventos de expansión y contracción.

public:
 property bool EnableClientScript { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public bool EnableClientScript { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.EnableClientScript : bool with get, set
Public Property EnableClientScript As Boolean

Valor de propiedad

Boolean

true para representar el script de cliente en exploradores compatibles; de lo contrario, false. De manera predeterminada, es true.

Atributos
ThemeableAttribute

Ejemplos

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar la propiedad para representar el EnableClientScript script del lado cliente que se usa para expandir y contraer nodos en exploradores compatibles. El segundo ejemplo de código proporciona datos XML de ejemplo para el primer ejemplo de código.

En el ejemplo de código siguiente se muestra cómo usar la propiedad para representar el EnableClientScript script del lado cliente que se usa para expandir y contraer nodos en exploradores compatibles. Observe que se requiere una publicación en el servidor para expandir y contraer un nodo cuando la EnableClientScript propiedad está establecida falseen . Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo, proporcionados después de este ejemplo de código, en un archivo denominado 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 EnableClientScript Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView EnableClientScript Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        EnableClientScript="true"
        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 EnableClientScript Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView EnableClientScript Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        EnableClientScript="true"
        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>

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

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

Comentarios

Use la EnableClientScript propiedad para especificar si el control representa el TreeView script del lado cliente en exploradores compatibles para controlar los eventos de expansión y contracción. Cuando esta propiedad se establece trueen , los exploradores compatibles ejecutan el código para expandir y contraer nodos en el cliente. Los datos del nodo de árbol deben conocerse de antemano para que el script del lado cliente funcione. El uso de un script de cliente impide que se devuelva una publicación al servidor cada vez que se expanda o contraiga un nodo.

Cuando los datos del nodo de árbol no se conocen de antemano, los nodos se pueden rellenar desde el cliente, si la PopulateNodesFromClient propiedad también se establece trueen . En este escenario, también debe proporcionar un método de control de eventos para que el TreeNodePopulate evento rellene los nodos. Para obtener más información sobre el rellenado de nodos del lado cliente, vea PopulateNodesFromClient.

Nota

Si la EnableClientScript propiedad se establece falseen , el TreeView control vuelve al servidor cada vez que se expande o contrae un nodo.

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

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también