XmlDataSource.Data 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 un bloc de données XML auquel le contrôle de source de données est lié.
public:
virtual property System::String ^ Data { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual string Data { get; set; }
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public virtual string Data { get; set; }
[<System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Data : string with get, set
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
member this.Data : string with get, set
Public Overridable Property Data As String
Valeur de propriété
Chaîne de données XML inline auxquelles le XmlDataSource contrôle est lié. La valeur par défaut est Empty.
- Attributs
Exceptions
Le document est chargé.
Exemples
L’exemple de code suivant montre comment utiliser un XmlDataSource contrôle pour afficher des données XML inline contenues par la Data propriété avec un TreeView contrôle.
<%@ 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" >
<data>
<Books>
<LanguageBooks>
<Book Title="Pure JavaScript" Author="Wyke, Gilliam, and Ting"/>
<Book Title="Effective C++ Second Edition" Author="Scott Meyers"/>
<Book Title="Assembly Language Step-By-Step" Author="Jeff Duntemann"/>
<Book Title="Oracle PL/SQL" Author="Steven Feuerstein"/>
</LanguageBooks>
<SecurityBooks>
<Book Title="Counter Hack" Author="Ed Skoudis"/>
</SecurityBooks>
</Books>
</data>
</asp:xmldatasource>
<!- 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" >
<data>
<Books>
<LanguageBooks>
<Book Title="Pure JavaScript" Author="Wyke, Gilliam, and Ting"/>
<Book Title="Effective C++ Second Edition" Author="Scott Meyers"/>
<Book Title="Assembly Language Step-By-Step" Author="Jeff Duntemann"/>
<Book Title="Oracle PL/SQL" Author="Steven Feuerstein"/>
</LanguageBooks>
<SecurityBooks>
<Book Title="Counter Hack" Author="Ed Skoudis"/>
</SecurityBooks>
</Books>
</data>
</asp:xmldatasource>
<!- 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>
Remarques
Dans les scénarios déclaratifs, la Data propriété est spécifiée en tant que propriété interne multiligne de l’objet XmlDataSource . Une propriété interne est compatible avec les données XML, car elle vous permet de mettre en forme les données XML de n’importe quelle façon et d’ignorer les problèmes de remplissage de caractères, tels que le remplissage de caractères.
Si les propriétés et Data les DataFile propriétés sont définies, la DataFile propriété est prioritaire et les données du fichier XML sont utilisées au lieu des données XML spécifiées dans la Data propriété.
Si vous modifiez la valeur de la Data propriété, l’événement DataSourceChanged est déclenché. Si la mise en cache est activée et que vous modifiez la valeur de Data, le cache est invalidé.