XmlDataSource Classe
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.
Représente une source de données XML pour les contrôles liés aux données.
public ref class XmlDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))]
public class XmlDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))>]
type XmlDataSource = class
inherit HierarchicalDataSourceControl
interface IDataSource
interface IListSourcePublic Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource- Héritage
- Attributs
- Implémente
Exemples
Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser un XmlDataSource contrôle avec un TreeView contrôle pour afficher des données XML à partir de l’exemple de fichier XML. Le deuxième exemple montre comment utiliser un XmlDataSource contrôle avec un contrôle avec Repeater un modèle pour afficher des données XML.
L’exemple de code suivant montre comment utiliser un XmlDataSource contrôle avec un TreeView contrôle pour afficher des données XML. le charge les XmlDataSource données XML à partir du fichier XML identifié par la DataFile propriété .
<%@ 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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
Le fichier XML de l’exemple de code contient les données suivantes :
<books>
<computerbooks>
<book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>
<book title="Straight Talk About Computers" author="Dean Straight"/>
<book title="You Can Combat Computer Stress!" author="Marjorie Green"/>
</computerbooks>
<cookbooks>
<book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>
</cookbooks>
</books>
L’exemple de code suivant montre comment utiliser un XmlDataSource contrôle avec un contrôle avec Repeater un modèle pour afficher des données XML. Le Repeater contrôle utilise une expression de liaison de données XPath pour lier des éléments de données dans le document XML que représente XmlDataSource . Pour plus d’informations sur XPath et XPathSelect la syntaxe de liaison de données, consultez la XPathBinder classe .
<%@ 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>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</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>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
Le fichier XML de l’exemple de code contient les données suivantes :
<?xml version="1.0" encoding="iso-8859-1"?>
<orders>
<order>
<customer id="12345" />
<customername>
<firstn>John</firstn>
<lastn>Smith</lastn>
</customername>
<transaction id="12345" />
<shipaddress>
<address1>1234 Tenth Avenue</address1>
<city>Bellevue</city>
<state>Washington</state>
<zip>98001</zip>
</shipaddress>
<summary>
<item dept="tools">screwdriver</item>
<item dept="tools">hammer</item>
<item dept="plumbing">fixture</item>
</summary>
</order>
</orders>
Remarques
Dans cette rubrique :
Introduction
Le XmlDataSource contrôle est un contrôle de source de données qui présente des données XML aux contrôles liés aux données. Le XmlDataSource contrôle peut être utilisé par les contrôles liés aux données pour afficher des données hiérarchiques et tabulaires. Le XmlDataSource contrôle est généralement utilisé pour afficher des données XML hiérarchiques dans des scénarios en lecture seule. Étant donné que le XmlDataSource contrôle étend la HierarchicalDataSourceControl classe, il fonctionne avec des données hiérarchiques. Le XmlDataSource contrôle implémente également l’interface IDataSource et fonctionne avec des données tabulaires ou de type liste.
Notes
Pour des raisons de sécurité, aucune des propriétés de contrôle n’est XmlDataSource stockée dans l’état d’affichage. Étant donné qu’il est techniquement possible de décoder le contenu de l’état d’affichage sur le client, le stockage d’informations sensibles sur la structure des données ou leur contenu peut vous exposer à une menace de divulgation d’informations. Notez que si vous devez stocker des informations telles que XPath la propriété dans l’état d’affichage, vous pouvez activer le chiffrement pour protéger le contenu en définissant ViewStateEncryptionMode sur la @ Page directive .
Les développeurs de pages utilisent le XmlDataSource contrôle pour afficher des données XML à l’aide de contrôles liés aux données.
Sources de données XML
le XmlDataSource charge généralement des données XML à partir d’un fichier XML, qui est spécifié par la DataFile propriété . Les données XML peuvent également être stockées directement par le contrôle de source de données sous forme de chaîne à l’aide de la Data propriété . Si vous souhaitez transformer les données XML avant qu’elles ne soient affichées par un contrôle lié aux données, vous pouvez fournir une feuille de style XSL (Extensible Stylesheet Language) pour la transformation. Comme pour les données XML, vous chargez généralement la feuille de style à partir d’un fichier, indiqué par la TransformFile propriété , mais vous pouvez également la stocker sous forme de chaîne directement à l’aide de la Transform propriété .
Mise à jour des données XML
Le XmlDataSource contrôle est couramment utilisé dans les scénarios de données en lecture seule où un contrôle lié aux données affiche des données XML. Toutefois, vous pouvez également utiliser le contrôle pour modifier des XmlDataSource données XML. Pour modifier les données XML, appelez la GetXmlDocument méthode pour récupérer un XmlDataDocument objet qui est une représentation en mémoire des données XML. Vous pouvez utiliser le modèle objet exposé par les XmlDataDocument objets et XmlNode qu’il contient ou utiliser une expression de filtrage XPath pour manipuler des données dans le document. Une fois que vous avez apporté des modifications à la représentation en mémoire des données XML, vous pouvez l’enregistrer sur le disque en appelant la Save méthode .
Certaines restrictions s’appliquent aux fonctionnalités d’édition du XmlDataSource contrôle :
Les données XML doivent être chargées à partir d’un fichier XML indiqué par la DataFile propriété , et non à partir du code XML inline spécifié dans la Data propriété .
Aucune transformation XSLT ne peut être spécifiée dans les Transform propriétés ou TransformFile .
La Save méthode ne gère pas les opérations d’enregistrement simultanées par différentes requêtes. Si plusieurs utilisateurs modifient un fichier XML via , XmlDataSourceil n’existe aucune garantie que tous les utilisateurs fonctionnent avec les mêmes données. Il est également possible qu’une Save opération échoue en raison de ces mêmes problèmes d’accès concurrentiel.
Spécification d’une transformation XSL
Une opération courante effectuée avec des données XML consiste à les transformer d’un jeu de données XML en un autre. Le XmlDataSource contrôle prend en charge les transformations XML avec les Transform propriétés et TransformFile , qui spécifient une feuille de style XSL à appliquer aux données XML avant qu’elles ne soient transmises à un contrôle lié aux données, et la TransformArgumentList propriété , qui vous permet de fournir des arguments de feuille de style XSLT dynamiques à utiliser par une feuille de style XSL pendant la transformation. Si vous spécifiez une expression de filtrage XPath à l’aide de la XPath propriété , elle est appliquée après la transformation.
Notes
La XmlDataSource classe utilise la classe dépréciée XslTransform pour effectuer des transformations XSL. Si vous souhaitez utiliser des fonctionnalités de feuille de style introduites après la dépréciation de la XslTransform classe, appliquez les transformations manuellement à l’aide de la XslCompiledTransform classe .
Filtrage à l’aide d’une expression XPath
Par défaut, le XmlDataSource contrôle charge toutes les données XML dans le fichier XML identifié par la DataFile propriété ou inclus dans la Data propriété, mais vous pouvez filtrer les données à l’aide d’une expression XPath. La XPath propriété prend en charge un filtre XPath-syntax qui est appliqué après le chargement et la transformation des données XML.
Mise en cache
Pour des raisons de performances, la mise en cache est activée pour le XmlDataSource contrôle par défaut. L’ouverture et la lecture d’un fichier XML sur le serveur chaque fois qu’une page est demandée peut réduire les performances de votre application. La mise en cache vous permet de réduire la charge de traitement sur votre serveur au détriment de la mémoire sur le serveur Web. dans la plupart des cas, il s’agit d’un bon compromis. Met XmlDataSource automatiquement en cache les données lorsque la EnableCaching propriété a la truevaleur , et la CacheDuration propriété est définie sur le nombre de secondes pendant lesquelles le cache stocke les données avant que le cache ne soit invalidé. Vous pouvez utiliser pour CacheExpirationPolicy affiner davantage le comportement de mise en cache du contrôle de source de données.
Fonctionnalités supplémentaires
Le tableau suivant répertorie les fonctionnalités supplémentaires prises en charge par le XmlDataSource contrôle .
| Fonctionnalité | Description |
|---|---|
| Tri | Non pris en charge par le XmlDataSource contrôle. |
| Filtrage | La XPath propriété peut être utilisée pour filtrer les données XML à l’aide d’une expression XPath appropriée. |
| Pagination | Non pris en charge par le XmlDataSource contrôle. |
| Mise à jour | Pris en charge en manipulant directement, XmlDataDocument puis en appelant la Save méthode . |
| Suppression | Pris en charge en manipulant directement, XmlDataDocument puis en appelant la Save méthode . |
| Insertion | Pris en charge en manipulant directement, XmlDataDocument puis en appelant la Save méthode . |
| Mise en cache | Activé par défaut, avec la CacheDuration propriété définie sur 0 (infini) et la CacheExpirationPolicy propriété définie sur Absolute. |
Objet Data View
Étant donné que le XmlDataSource contrôle prend en charge les contrôles liés aux données qui affichent des données hiérarchiques ainsi que les contrôles qui affichent des données tabulaires, le contrôle de source de données prend en charge plusieurs types d’objets de vue de source de données sur ses données XML sous-jacentes. Le XmlDataSource contrôle récupère un objet nommé XmlDataSourceView unique lorsqu’il est utilisé avec un contrôle lié aux données qui affiche des données tabulaires. La GetViewNames méthode identifie cette vue nommée unique. Lorsqu’il est utilisé avec un contrôle lié aux données qui affiche des données hiérarchiques, le XmlDataSource contrôle récupère un XmlHierarchicalDataSourceView pour tout chemin hiérarchique unique passé à la GetHierarchicalView méthode .
Syntaxe déclarative
<asp:XmlDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
DataFile="string"
EnableCaching="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnTransforming="Transforming event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
TransformArgumentList="string"
TransformFile="string"
Visible="True|False"
XPath="string"
>
<Data>string</Data>
<Transform>string</Transform>
</asp:XmlDataSource>
Constructeurs
| XmlDataSource() |
Crée une instance de la classe XmlDataSource. |
Propriétés
| Adapter |
Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| CacheDuration |
Obtient ou définit la durée, en secondes, de la mise en cache par le contrôle de source de données des données qu'il a récupérées. |
| CacheExpirationPolicy |
Obtient ou définit la stratégie d'expiration du cache combinée à la durée de mise en cache, pour décrire le comportement de mise en cache du cache que le contrôle de source de données utilise. |
| CacheKeyContext |
Obtient ou définit la valeur de la clé de cache pour le contrôle de source de données à partir de l'état d'affichage, ou ajoute la clé de cache à l'état d'affichage. |
| CacheKeyDependency |
Obtient ou définit une dépendance de clé définie par l'utilisateur qui est liée à tous les objets cache de données créés par le contrôle de source de données. Tous les objets mis en cache expirent explicitement lorsque la clé expire. |
| ChildControlsCreated |
Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l'identificateur de contrôle serveur généré par ASP.NET. (Hérité de HierarchicalDataSourceControl) |
| ClientIDMode |
Cette propriété n'est pas utilisée pour les contrôles de source de données. (Hérité de HierarchicalDataSourceControl) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control) |
| Context |
Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control) |
| Controls |
Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de HierarchicalDataSourceControl) |
| Data |
Obtient ou définit un bloc de données XML avec lequel le contrôle de source de données crée une liaison. |
| DataFile |
Spécifie le nom d'un fichier XML auquel la source de données est liée. |
| DataItemContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control) |
| EnableCaching |
Obtient ou définit une valeur indiquant si la mise en cache de données du contrôle XmlDataSource est activée. |
| EnableTheming |
Obtient une valeur indiquant si cet objet prend en charge des thèmes. (Hérité de HierarchicalDataSourceControl) |
| EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
| HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control) |
| ID |
Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control) |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control) |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur. (Hérité de Control) |
| Page |
Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control) |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control) |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control) |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit l'apparence à appliquer au contrôle HierarchicalDataSourceControl. (Hérité de HierarchicalDataSourceControl) |
| TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
| TemplateSourceDirectory |
Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control) |
| Transform |
Obtient ou définit un bloc des données XSL (Extensible Stylesheet Language) qui définit une transformation XSLT à exécuter sur les données XML gérées par le contrôle XmlDataSource. |
| TransformArgumentList |
Fournit une liste d'arguments XSLT utilisés avec la feuille de style définie par la propriété Transform ou TransformFile pour exécuter une transformation sur les données XML. |
| TransformFile |
Spécifie le nom d'un fichier XSL (Extensible Stylesheet Language) (.xsl) qui définit une transformation XSLT à exécuter sur les données XML gérées par le contrôle XmlDataSource. |
| UniqueID |
Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control) |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control) |
| ViewState |
Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control) |
| ViewStateMode |
Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control) |
| Visible |
Obtient ou définit une valeur indiquant l'affichage visuel ou non du contrôle. (Hérité de HierarchicalDataSourceControl) |
| XPath |
Spécifie une expression XPath à appliquer aux données XML contenues par la propriété Data ou par le fichier XML indiqué par la propriété DataFile. |
Méthodes
| AddedControl(Control, Int32) |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style qui sont définies dans la feuille de style de la page au contrôle. (Hérité de HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Commence le traçage au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Affecte à la valeur ClientID mise en cache la valeur |
| ClearChildControlState() |
Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildViewState() |
Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearEffectiveClientIDMode() |
Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control) |
| CreateChildControls() |
Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu. (Hérité de Control) |
| CreateControlCollection() |
Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de HierarchicalDataSourceControl) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control) |
| DataBind(Boolean) |
Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control) |
| DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
| Dispose() |
Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au traçage au moment du design des données de rendu. (Hérité de Control) |
| EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| FindControl(String) |
Recherche un contrôle serveur possédant le paramètre |
| FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
| Focus() |
Définit le focus d'entrée sur le contrôle. (Hérité de HierarchicalDataSourceControl) |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetHierarchicalView(String) |
Obtient l'objet de vue de source de données pour le contrôle XmlDataSource. Le paramètre |
| GetRouteUrl(Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control) |
| GetXmlDocument() |
Charge les données XML en mémoire, soit directement du stockage des données sous-jacent ou soit du cache, et les retourne sous la forme d'un objet XmlDataDocument. |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de HierarchicalDataSourceControl) |
| HasEvents() |
Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState(). (Hérité de Control) |
| LoadViewState(Object) |
Restaure les informations d’état d’affichage d’une précédente requête de page enregistrées par la méthode SaveViewState(). (Hérité de Control) |
| MapPathSecure(String) |
Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page. (Hérité de Control) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnDataSourceChanged(EventArgs) |
Déclenche l’événement DataSourceChanged. (Hérité de HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Déclenche l’événement Init. (Hérité de Control) |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnPreRender(EventArgs) |
Déclenche l’événement PreRender. (Hérité de Control) |
| OnTransforming(EventArgs) |
Élève l'événement Transforming avant que le contrôle XmlDataSource exécute une transformation XSLT sur ses données XML. |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control) |
| RemovedControl(Control) |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
| Render(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter, qui écrit le contenu à rendre sur le client. (Hérité de Control) |
| RenderChildren(HtmlTextWriter) |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé. (Hérité de HierarchicalDataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control) |
| ResolveAdapter() |
Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control) |
| Save() |
Enregistre sur disque les données XML contenues en mémoire par le contrôle XmlDataSource si la propriété DataFile est définie. |
| SaveControlState() |
Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre les changements d’état d’affichage du contrôle serveur qui se sont produits depuis que la page a été republiée sur le serveur. (Hérité de Control) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| TrackViewState() |
Provoque le suivi des modifications de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. Cet objet est accessible via la propriété ViewState. (Hérité de Control) |
Événements
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| Disposed |
Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control) |
| Load |
Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control) |
| PreRender |
Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control) |
| Transforming |
Se produit avant que la feuille de style qui est définie par la propriété Transform ou identifiée par la propriété TransformFile soit appliquée aux données XML. |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IDataSource.DataSourceChanged |
Pour obtenir une description de ce membre, consultez DataSourceChanged. |
| IDataSource.GetView(String) |
Obtient l'affichage de source de données associé au contrôle de source de données. |
| IDataSource.GetViewNames() |
Pour obtenir une description de ce membre, consultez GetViewNames(). |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IHierarchicalDataSource.DataSourceChanged |
Se produit lorsque HierarchicalDataSourceControl a changé d'une façon qui affecte les contrôles liés aux données. (Hérité de HierarchicalDataSourceControl) |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Obtient l'objet d'assistance à l'affichage de l'interface IHierarchicalDataSource pour le chemin d'accès spécifié. (Hérité de HierarchicalDataSourceControl) |
| IListSource.ContainsListCollection |
Pour obtenir une description de ce membre, consultez ContainsListCollection. |
| IListSource.GetList() |
Pour obtenir une description de ce membre, consultez GetList(). |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
Méthodes d’extension
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
| GetDefaultValues(IDataSource) |
Obtient la collection des valeurs par défaut pour la source de données spécifiée. |
| GetMetaTable(IDataSource) |
Obtient les métadonnées pour une table dans l'objet source de données spécifié. |
| TryGetMetaTable(IDataSource, MetaTable) |
Détermine si des métadonnées de table sont disponibles. |
S’applique à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour