Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
BaseDataBoundControl.DataSource, propriété
Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données.
Assembly : System.Web (dans System.Web.dll)
[BindableAttribute(true)] [ThemeableAttribute(false)] public virtual Object DataSource { get; set; }
Valeur de propriété
Type : System.ObjectObjet qui représente la source de données de laquelle le contrôle lié aux données récupère ses données. La valeur par défaut est null.
Si vous définissez la propriété DataSource, la méthode ValidateDataSource est appelée. De plus, si le contrôle lié aux données est déjà initialisé, la méthode OnDataPropertyChanged est appelée pour affecter la valeur true à la propriété RequiresDataBinding.
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 Thèmes et apparences ASP.NET.
L'exemple de code suivant illustre l'utilisation de la propriété DataSource d'un contrôle lié aux données. Dans cet exemple, le contrôle GridView est lié à un objet DataSet. Une fois la propriété DataSource définie, la méthode DataBind est appelée explicitement.
<%@ Page language="C#" %> <%@ import namespace="System.Data" %> <%@ import namespace="System.Data.SqlClient" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> void Page_Load(Object sender, EventArgs e) { // This example uses Microsoft SQL Server and connects // to the Northwind sample database. The data source needs // to be bound to the GridView control only when the // page is first loaded. Thereafter, the values are // stored in view state. if(!IsPostBack) { // Declare the query string. String queryString = "Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"; // Run the query and bind the resulting DataSet // to the GridView control. DataSet ds = GetData(queryString); if (ds.Tables.Count > 0) { AuthorsGridView.DataSource = ds; AuthorsGridView.DataBind(); } else { Message.Text = "Unable to connect to the database."; } } } DataSet GetData(String queryString) { // Retrieve the connection string stored in the Web.config file. String connectionString = ConfigurationManager.ConnectionStrings["NorthWindConnectionString"].ConnectionString; DataSet ds = new DataSet(); try { // Connect to the database and run the query. SqlConnection connection = new SqlConnection(connectionString); SqlDataAdapter adapter = new SqlDataAdapter(queryString, connection); // Fill the DataSet. adapter.Fill(ds); } catch(Exception ex) { // The connection failed. Display an error message. Message.Text = "Unable to connect to the database."; } return ds; } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>GridView DataBind Example</title> </head> <body> <form id="form1" runat="server"> <h3>GridView DataBind Example</h3> <asp:label id="Message" forecolor="Red" runat="server"/> <br/> <asp:gridview id="AuthorsGridView" autogeneratecolumns="true" runat="server"> </asp:gridview> </form> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
