Freigeben über

TreeView.EnableClientScript Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das TreeView-Steuerelement clientseitiges Skript zum Verarbeiten von Erweiterungs- oder Reduzierungsereignissen rendert.

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

Eigenschaftswert

Boolean

true, um das clientseitige Skript in kompatiblen Browsern zu rendern, andernfalls false. Der Standardwert ist true.

Attribute
ThemeableAttribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die -Eigenschaft zum Rendern eines EnableClientScript clientseitigen Skripts verwendet wird, das zum Erweitern und Reduzieren von Knoten in kompatiblen Browsern verwendet wird. Das zweite Codebeispiel enthält XML-Beispieldaten für das erste Codebeispiel.

Im folgenden Codebeispiel wird veranschaulicht, wie die -Eigenschaft zum Rendern eines EnableClientScript clientseitigen Skripts verwendet wird, das zum Erweitern und Reduzieren von Knoten in kompatiblen Browsern verwendet wird. Beachten Sie, dass ein Post auf dem Server erforderlich ist, um einen Knoten zu erweitern und zu reduzieren, wenn die EnableClientScript -Eigenschaft auf falsefestgelegt ist. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei namens Book.xml kopieren.


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

Das folgende Codebeispiel enthält XML-Beispieldaten für das vorangehende Codebeispiel.

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

Hinweise

Verwenden Sie die EnableClientScript -Eigenschaft, um anzugeben, ob das TreeView Steuerelement clientseitige Skripts in kompatiblen Browsern rendert, um erweiternde und reduzierende Ereignisse zu behandeln. Wenn diese Eigenschaft auf truefestgelegt ist, führen kompatible Browser den Code aus, um Knoten auf dem Client zu erweitern und zu reduzieren. Die Strukturknotendaten müssen im Voraus bekannt sein, damit das clientseitige Skript funktioniert. Die Verwendung eines Clientskripts verhindert, dass jedes Mal, wenn ein Knoten erweitert oder reduziert wird, ein Postback auf den Server erfolgt.

Wenn die Strukturknotendaten im Voraus nicht bekannt sind, können Knoten vom Client aufgefüllt werden, wenn die PopulateNodesFromClient -Eigenschaft ebenfalls auf truefestgelegt ist. In diesem Szenario müssen Sie auch eine Ereignisbehandlungsmethode für das TreeNodePopulate Ereignis bereitstellen, um die Knoten aufzufüllen. Weitere Informationen zur clientseitigen Knotenauffüllung finden Sie unter PopulateNodesFromClient.

Hinweis

Wenn die EnableClientScript -Eigenschaft auf falsefestgelegt ist, sendet das TreeView Steuerelement jedes Mal, wenn ein Knoten erweitert oder reduziert wird, an den Server zurück.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen