TreeView.EnableClientScript Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si le contrôle restitue le TreeView script côté client pour gérer les é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 afficher 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 les nœuds sur les 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 les nœuds sur les navigateurs compatibles. Notez qu’un billet sur le serveur est nécessaire pour développer et réduire un nœud lorsque la EnableClientScript propriété est définie falsesur . Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données XML, fourni 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 pour gérer les événements de développement et de réduction. Lorsque cette propriété est définie truesur , les navigateurs compatibles exécutent le code pour développer et réduire les nœuds sur le client. Les données de nœud d’arborescence doivent être connues à l’avance pour que le script côté client fonctionne. L’utilisation du 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 de nœud d’arborescence ne sont pas connues à l’avance, les nœuds peuvent être renseignés à partir du client, si la PopulateNodesFromClient propriété est également définie truesur . 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 des nœuds côté client, consultez PopulateNodesFromClient.
Note
Si la propriété est définie falsesur , le TreeViewEnableClientScript 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 des thèmes ou des thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes et peaux.