TreeView.EnableClientScript Propriété

Définition

Obtient ou définit une valeur indiquant si le contrôle TreeView restitue le script côté client pour gérer des événements de développement et de réduction.

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

Valeur de propriété

true pour restituer le script côté client sur les navigateurs compatibles ; sinon, false. La valeur par défaut est true.

Attributs

Exemples

Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser la propriété pour afficher le EnableClientScript script côté client utilisé pour développer et réduire des nœuds sur des navigateurs compatibles. Le deuxième exemple de code fournit des exemples de données XML pour le premier exemple de code.

L’exemple de code suivant montre comment utiliser la propriété pour afficher le EnableClientScript script côté client utilisé pour développer et réduire des nœuds sur des navigateurs compatibles. Notez qu’une publication sur le serveur est nécessaire pour développer et réduire un nœud lorsque la EnableClientScript propriété a la falsevaleur . Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML, fournis après cet exemple de code, dans un fichier nommé 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>

L’exemple de code suivant fournit des exemples de données XML pour l’exemple de code précédent.

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

Remarques

Utilisez la EnableClientScript propriété pour spécifier si le contrôle restitue le TreeView script côté client sur les navigateurs compatibles afin de gérer les événements de développement et de réduction. Lorsque cette propriété a la truevaleur , les navigateurs compatibles exécutent le code pour développer et réduire les nœuds sur le client. Les données du nœud d’arborescence doivent être connues à l’avance pour que le script côté client fonctionne. L’utilisation d’un script client empêche une publication sur le serveur chaque fois qu’un nœud est développé ou réduit.

Lorsque les données du nœud d’arborescence ne sont pas connues à l’avance, les nœuds peuvent être remplis à partir du client, si la PopulateNodesFromClient propriété a également la truevaleur . Dans ce scénario, vous devez également fournir une méthode de gestion des événements pour que l’événement TreeNodePopulate remplisse les nœuds. Pour plus d’informations sur la population de nœuds côté client, consultez PopulateNodesFromClient.

Notes

Si la EnableClientScript propriété est définie sur false, le TreeView contrôle revient au serveur chaque fois qu’un nœud est développé ou réduit.

La valeur de cette propriété est stockée dans l’état d’affichage.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes et apparences.

S’applique à

Voir aussi