TreeView.EnableClientScript TreeView.EnableClientScript TreeView.EnableClientScript TreeView.EnableClientScript Property

Definizione

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.Gets or sets a value indicating whether the TreeView control renders client-side script to handle expanding and collapsing events.

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

Valore della proprietà

true per eseguire il rendering dello script lato client su browser compatibili; in caso contrario, false.true to render the client-side script on compatible browsers; otherwise, false. Il valore predefinito è true.The default is true.

Esempi

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come utilizzare EnableClientScript la proprietà per eseguire il rendering dello script lato client utilizzato per espandere e comprimere i nodi nei browser compatibili.The first code example demonstrates how to use the EnableClientScript property to render client-side script that is used to expand and collapse nodes on compatible browsers. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.The second code example provides sample XML data for the first code example.

Nell'esempio di codice riportato di seguito viene illustrato EnableClientScript come utilizzare la proprietà per eseguire il rendering dello script lato client utilizzato per espandere e comprimere i nodi nei browser compatibili.The following code example demonstrates how to use the EnableClientScript property to render client-side script that is used to expand and collapse nodes on compatible browsers. Si noti che è necessario un post sul server per espandere e comprimere un nodo EnableClientScript quando la proprietà è falseimpostata su.Notice that a post to the server is required to expand and collapse a node when the EnableClientScript property is set to 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.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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 riportato di seguito vengono forniti dati XML di esempio per l'esempio di codice precedente.The following code example provides sample XML data for the preceding code example.

<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 TreeView controllo esegue il rendering dello script lato client nei browser compatibili per gestire gli eventi di espansione e compressione.Use the EnableClientScript property to specify whether the TreeView control renders client-side script on compatible browsers to handle expanding and collapsing events. Quando questa proprietà è impostata su true, i browser compatibili eseguono il codice per espandere e comprimere i nodi nel client.When this property is set to true, compatible browsers execute the code to expand and collapse nodes on the client. Per il corretto funzionamento dello script lato client, i dati del nodo della struttura ad albero devono essere noti in anticipo.The tree node data must be known in advance for the client-side script to work. L'uso di script client impedisce il postback al server ogni volta che un nodo viene espanso o compresso.Using client script prevents a post back to the server each time a node is expanded or collapsed.

Quando i dati del nodo della struttura ad albero non sono noti in anticipo, i nodi possono essere popolati PopulateNodesFromClient dal client, se la trueproprietà è impostata anche su.When the tree node data is not known in advance, nodes can be populated from the client, if the PopulateNodesFromClient property is also set to true. In questo scenario, è necessario fornire anche un metodo di gestione degli eventi per TreeNodePopulate l'evento per popolare i nodi.In this scenario, you must also provide an event-handling method for the TreeNodePopulate event to populate the nodes. Per ulteriori informazioni sul popolamento del nodo lato client, vedere PopulateNodesFromClient.For more information on client-side node population, see 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.If the EnableClientScript property is set to false, the TreeView control posts back to the server each time a node is expanded or collapsed.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile.This property cannot be set by themes or style sheet themes. Per ulteriori informazioni, vedere ThemeableAttribute e ASP.NET temi e interfacce.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Si applica a

Vedi anche