TreeView.EnableClientScript Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu označující, zda TreeView ovládací prvek vykresluje skript na straně klienta pro zpracování rozbalování a sbalování událostí.
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
Hodnota vlastnosti
true
vykreslit skript na straně klienta v kompatibilních prohlížečích; v opačném případě . false
Výchozí formát je true
.
- Atributy
Příklady
Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak pomocí EnableClientScript vlastnosti vykreslit skript na straně klienta, který se používá k rozbalení a sbalení uzlů v kompatibilních prohlížečích. Druhý příklad kódu poskytuje ukázková data XML pro první příklad kódu.
Následující příklad kódu ukazuje, jak pomocí EnableClientScript vlastnosti vykreslit skript na straně klienta, který se používá k rozbalení a sbalení uzlů v kompatibilních prohlížečích. Všimněte si, že k rozbalení a sbalení uzlu je potřeba příspěvek na server, pokud EnableClientScript je vlastnost nastavená na false
. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML za tímto příkladem kódu do souboru s názvem 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>
Následující příklad kódu poskytuje ukázková data XML pro předchozí příklad kódu.
<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>
Poznámky
EnableClientScript Pomocí vlastnosti určete, zda TreeView ovládací prvek vykresluje skript na straně klienta v kompatibilních prohlížečích pro zpracování rozbalení a sbalování událostí. Pokud je tato vlastnost nastavena na true
, kompatibilní prohlížeče spustí kód pro rozbalení a sbalení uzlů v klientovi. Aby skript na straně klienta fungoval, musí být předem známá data uzlu stromové struktury. Použití klientského skriptu zabrání při každém rozbalení nebo sbalení uzlu zpět na server.
Pokud nejsou data uzlu stromové struktury předem známa, je možné uzly naplnit z klienta, pokud PopulateNodesFromClient
je vlastnost také nastavena na true
. V tomto scénáři je také nutné zadat metodu zpracování událostí pro TreeNodePopulate událost, která naplní uzly. Další informace o souboru uzlů na straně klienta najdete v tématu PopulateNodesFromClient.
Poznámka
EnableClientScript Pokud je vlastnost nastavená na false
, TreeView vrátí se ovládací prvek zpět na server při každém rozbalení nebo sbalení uzlu.
Hodnota této vlastnosti je uložena ve stavu zobrazení.
Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET motivy a vzhledy.