TreeView.EnableClientScript 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出 TreeView 控制項是否呈現用戶端指令碼,以處理展開和摺疊事件。
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
屬性值
true
表示在相容的瀏覽器上呈現用戶端指令碼,否則為 false
。 預設為 true
。
- 屬性
範例
本節包含兩個程式碼範例。 第一個程式代碼範例示範如何使用 EnableClientScript 屬性來轉譯用戶端腳本,以在相容的瀏覽器上展開和折疊節點。 第二個程式代碼範例會提供第一個程式代碼範例的範例 XML 數據。
下列程式代碼範例示範如何使用 EnableClientScript 屬性來轉譯用戶端腳本,以在相容的瀏覽器上展開和折疊節點。 請注意,當 屬性設定false
為 時EnableClientScript,需要對伺服器的貼文展開和折疊節點。 若要讓此範例正常運作,您必須將此程式碼範例之後提供的範例 XML 數據複製到名為 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>
下列程式代碼範例提供上述程式代碼範例的範例 XML 數據。
<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>
備註
EnableClientScript使用 屬性可指定控件是否會TreeView在相容的瀏覽器上呈現用戶端腳本,以處理展開和折疊事件。 當此屬性設定為 true
時,相容的瀏覽器會執行程式代碼來展開和折疊用戶端上的節點。 用戶端文本必須事先知道樹狀節點數據才能運作。 使用用戶端腳本可防止每次展開或折疊節點時回傳至伺服器。
當事先不知道樹狀節點數據時,如果 PopulateNodesFromClient
屬性也設定為 true
,則可以從用戶端填入節點。 在此案例中,您也必須提供事件處理方法,讓 TreeNodePopulate 事件填入節點。 如需用戶端節點母體延伸的詳細資訊,請參閱 PopulateNodesFromClient。
注意
EnableClientScript如果屬性設定false
為 ,則TreeView控件會在每次展開或折疊節點時回傳至伺服器。
這個屬性的值會儲存在檢視狀態中。
這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊,請參閱 ThemeableAttribute 和 ASP.NET 主題和外觀。