Condividi tramite

TreeView.EnableClientScript Proprietà

Definizione

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

Ottiene o imposta un valore che indica se il controllo esegue il TreeView rendering dello script lato client per gestire eventi di espansione e 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 sul lato client nei browser compatibili; in caso contrario, false. Il valore predefinito è true.

Attributi
ThemeableAttribute

Esempio

Questa sezione contiene due esempi di codice. Il primo esempio di codice illustra come usare la proprietà per eseguire il EnableClientScript rendering dello script sul lato client usato per espandere e comprimere i nodi nei browser compatibili. Il secondo esempio di codice fornisce 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. Affinché questo esempio funzioni correttamente, è 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 TreeView rendering dello 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 il funzionamento dello script sul 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 fornire anche un metodo di gestione degli eventi per popolare TreeNodePopulate i nodi. Per altre informazioni sul popolamento dei nodi sul lato client, vedere PopulateNodesFromClient.

Annotazioni

Se la EnableClientScript proprietà è impostata su false, il controllo esegue il TreeView 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 in base a temi o temi del foglio di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Vedi anche