TreeView.EnableClientScript 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取或设置一个值，指示 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

属性值

Boolean

若要在兼容的浏览器上呈现客户端脚本，则为 true；否则为 false。 默认值为 true。

属性
ThemeableAttribute

示例

本部分包含两个代码示例。 第一个代码示例演示如何使用 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 主题和皮肤。

适用于

另请参阅