語言

TreeView.EnableClientScript 屬性

定義

取得或設定一個值,指示控制項是否 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 特性來渲染用戶端腳本,該腳本用於在相容瀏覽器上擴展與收斂節點。 請注意,當屬性 EnableClientScript 設為 false時,需要對伺服器發送一個 post 來擴展和收縮節點。 為了讓此範例正常運作,您必須將範例 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。

Note

如果屬性 EnableClientScript 設為 false,每次節點展開或崩潰時, TreeView 控制項就會回傳給伺服器。

此屬性的價值會儲存在視圖狀態。

此屬性無法由主題或樣式表主題設定。 更多資訊請參閱 ThemeableAttribute 並 ASP.NET 主題與皮膚。

適用於

另請參閱