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 属性呈现用于在兼容浏览器上展开和折叠节点的客户端脚本。 请注意,当 属性设置为 falseEnableClientScript,需要向服务器发布以展开和折叠节点。 若要使此示例正常工作,必须将在此代码示例后面提供的示例 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 每次展开或折叠节点时,控件都会发回服务器。

此属性的值存储在视图状态中。

无法通过主题或样式表主题设置此属性。 有关详细信息,请参阅 ThemeableAttributeASP.NET 主题和外观

适用于

另请参阅