TreeView.EnableClientScript Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das TreeView Steuerelement clientseitige Skript zum Behandeln von Erweiterungs- und Reduzieren-Ereignissen 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, setPublic Property EnableClientScript As BooleanEigenschaftswert
trueum das clientseitige Skript in kompatiblen Browsern zu rendern; andernfalls . false Der Standardwert lautet true.
- Attribute
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie EnableClientScript die Eigenschaft zum Rendern von clientseitigem Skript verwendet wird, das zum Erweitern und Reduzieren von Knoten in kompatiblen Browsern verwendet wird. Im zweiten Codebeispiel werden XML-Beispieldaten für das erste Codebeispiel bereitgestellt.
Im folgenden Codebeispiel wird veranschaulicht, wie EnableClientScript die Eigenschaft zum Rendern von clientseitigem Skript verwendet wird, das zum Erweitern und Reduzieren von Knoten in kompatiblen Browsern verwendet wird. Beachten Sie, dass ein Beitrag auf dem Server erforderlich ist, um einen Knoten zu erweitern und zu reduzieren, wenn die EnableClientScript Eigenschaft auf false". Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Book.xmlkopieren.
<%@ 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>
Im folgenden Codebeispiel werden XML-Beispieldaten für das vorangehende Codebeispiel bereitgestellt.
<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 erweiterungs- und reduzierende Ereignisse zu behandeln. Wenn diese Eigenschaft auf true festgelegt 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 ein Beitrag bei jedem Erweitern oder Reduzieren eines Knotens wieder auf dem Server bereitgestellt wird.
Wenn die Strukturknotendaten im Voraus nicht bekannt sind, können Knoten vom Client ausgefüllt werden, wenn die PopulateNodesFromClient Eigenschaft auch auf .true In diesem Szenario müssen Sie auch eine Ereignisbehandlungsmethode bereitstellen, mit der das TreeNodePopulate Ereignis die Knoten auffüllt. Weitere Informationen zur clientseitigen Knotengesamtheit finden Sie unter PopulateNodesFromClient.
Hinweis
Wenn die EnableClientScript Eigenschaft auf false festgelegt ist, sendet das TreeView Steuerelement jedes Mal, wenn ein Knoten erweitert oder reduziert wird, wieder auf 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.
