Compartilhar via

TreeView.EnableClientScript Propriedade

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define um valor que indica se o controle renderiza o TreeView script do lado do cliente para lidar com eventos de expansão e recolhimento.

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

Boolean

true para renderizar o script do lado do cliente em navegadores compatíveis; caso contrário, false. O padrão é true.

Atributos
ThemeableAttribute

Exemplos

Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como usar a propriedade para renderizar o EnableClientScript script do lado do cliente usado para expandir e recolher nós em navegadores compatíveis. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.

O exemplo de código a seguir demonstra como usar a propriedade para renderizar o EnableClientScript script do lado do cliente usado para expandir e recolher nós em navegadores compatíveis. Observe que uma postagem no servidor é necessária para expandir e recolher um nó quando a EnableClientScript propriedade é definida como false. Para que este exemplo funcione corretamente, você deve copiar os dados XML de exemplo, fornecidos após este exemplo de código, para um arquivo chamado 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>

O exemplo de código a seguir fornece dados XML de exemplo para o exemplo 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>

Comentários

Use a EnableClientScript propriedade para especificar se o controle renderiza o TreeView script do lado do cliente em navegadores compatíveis para lidar com eventos de expansão e recolhimento. Quando essa propriedade é definida como true, navegadores compatíveis executam o código para expandir e recolher nós no cliente. Os dados do nó de árvore devem ser conhecidos com antecedência para que o script do lado do cliente funcione. O uso do script do cliente impede que uma postagem retorne ao servidor sempre que um nó for expandido ou recolhido.

Quando os dados do nó de árvore não são conhecidos com antecedência, os nós podem ser preenchidos do cliente, se a PopulateNodesFromClient propriedade também estiver definida como true. Nesse cenário, você também deve fornecer um método de manipulação de eventos para que o TreeNodePopulate evento preencha os nós. Para obter mais informações sobre a população de nós do lado do cliente, consulte PopulateNodesFromClient.

Observação

Se a EnableClientScript propriedade estiver definida como false, o TreeView controle retornará ao servidor sempre que um nó for expandido ou recolhido.

O valor dessa propriedade é armazenado no estado de exibição.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.

Aplica-se a

Confira também