TreeView.EnableClientScript Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore che indica se il controllo TreeView esegue il rendering dello script lato client per gestire gli eventi di espansione e di compressione.

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

Valore della proprietà

Boolean

true per eseguire il rendering dello script lato client su browser compatibili; in caso contrario, false. Il valore predefinito è true.

Attributi
ThemeableAttribute

Esempio

In questa sezione sono riportati due esempi di codice. Il primo esempio di codice illustra come usare la proprietà per eseguire il EnableClientScript rendering dello script lato client usato per espandere e comprimere i nodi nei browser compatibili. Nel secondo esempio di codice vengono forniti dati XML di esempio per il primo esempio di codice.

Nell'esempio di codice seguente viene illustrato come usare la proprietà per eseguire il EnableClientScript rendering dello script lato client usato per espandere e comprimere i nodi nei browser compatibili. Si noti che è necessario un post al server per espandere e comprimere un nodo quando la EnableClientScript proprietà è impostata su false. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato 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>

Nell'esempio di codice seguente vengono forniti dati XML di esempio per l'esempio di codice precedente.

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

Commenti

Utilizzare la EnableClientScript proprietà per specificare se il controllo esegue il rendering dello TreeView script lato client nei browser compatibili per gestire eventi di espansione e compressione. Quando questa proprietà è impostata su true, i browser compatibili eseguono il codice per espandere e comprimere i nodi nel client. I dati del nodo della struttura ad albero devono essere noti in anticipo per consentire il funzionamento dello script lato client. L'uso dello script client impedisce un postback al server ogni volta che un nodo viene espanso o compresso.

Quando i dati del nodo della struttura ad albero non sono noti in anticipo, i nodi possono essere popolati dal client, se la PopulateNodesFromClient proprietà è impostata anche su true. In questo scenario, è necessario specificare anche un metodo di gestione degli eventi per popolare TreeNodePopulate i nodi. Per altre informazioni sul popolamento di nodi lato client, vedere PopulateNodesFromClient.

Nota

Se la EnableClientScript proprietà è impostata su false, il TreeView controllo esegue il postback al server ogni volta che un nodo viene espanso o compresso.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Vedi anche