Share via

TreeView.EnableClientScript Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość wskazującą, czy kontrolka TreeView renderuje skrypt po stronie klienta do obsługi zdarzeń rozszerzania i zwijania.

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

Wartość właściwości

Boolean

true renderowanie skryptu po stronie klienta w zgodnych przeglądarkach; w przeciwnym razie , false. Wartość domyślna to true.

Atrybuty
ThemeableAttribute

Przykłady

Ten rozdział zawiera dwa przykłady kodu. W pierwszym przykładzie kodu pokazano, jak używać EnableClientScript właściwości do renderowania skryptu po stronie klienta używanego do rozwijania i zwijania węzłów w zgodnych przeglądarkach. Drugi przykład kodu zawiera przykładowe dane XML dla pierwszego przykładu kodu.

W poniższym przykładzie kodu pokazano, jak używać EnableClientScript właściwości do renderowania skryptu po stronie klienta używanego do rozwijania i zwijania węzłów w zgodnych przeglądarkach. Zwróć uwagę, że wpis na serwerze jest wymagany do rozwinięcia i zwinięcia węzła, gdy właściwość jest ustawiona EnableClientScript na false. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML podane po tym przykładzie kodu do pliku o nazwie 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>

Poniższy przykład kodu zawiera przykładowe dane XML dla poprzedniego przykładu kodu.

<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>

Uwagi

EnableClientScript Użyj właściwości , aby określić, czy TreeView kontrolka renderuje skrypt po stronie klienta w zgodnych przeglądarkach, aby obsługiwać rozszerzanie i zwijanie zdarzeń. Gdy ta właściwość jest ustawiona na true, zgodne przeglądarki wykonują kod w celu rozwijania i zwijania węzłów na kliencie. Dane węzła drzewa muszą być wcześniej znane, aby skrypt po stronie klienta działał. Użycie skryptu klienta uniemożliwia powrót do serwera po każdym rozwinięciu lub zwinięciu węzła.

Gdy dane węzła drzewa nie są znane z wyprzedzeniem, węzły można wypełnić z klienta, jeśli PopulateNodesFromClient właściwość jest również ustawiona na truewartość . W tym scenariuszu należy również podać metodę obsługi zdarzeń dla TreeNodePopulate zdarzenia w celu wypełnienia węzłów. Aby uzyskać więcej informacji na temat populacji węzłów po stronie klienta, zobacz PopulateNodesFromClient.

Uwaga

Jeśli właściwość jest ustawiona na falsewartość , kontrolka EnableClientScriptTreeView publikuje z powrotem na serwerze za każdym razem, gdy węzeł jest rozwinięty lub zwinięty.

Wartość tej właściwości jest przechowywana w stanie widoku.

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skórki.

Dotyczy

Zobacz też