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 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 false
valeur . Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML fournies 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 affiche 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é a la true
valeur , 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 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 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é a également la true
valeur . 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é a la false
valeur , 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 skins.