Connexion

Select the product you need help with

Vue d'ensemble de la liaison de donn�es ASP.NET

Num�ro d'article: 307860 - Voir les produits auxquels s'applique cet article

Cet article se r�f�re aux espaces de noms de la biblioth�que de classes Microsoft�.NET�Framework suivants�:

System.Data
System.Data.SqlClient

R�sum�

Cet article pr�sente la liaison de donn�es�ASP.NET.

Pour d'autres vues d'ensemble d'ASP.NET, reportez-vous � l'article suivant dans la Base de connaissances Microsoft�:

305140

(http://support.microsoft.com/kb/305140/fr/ )

Guide�ASP.NET

Retour au d�but | Envoyer des commentaires

La liaison de donn�es ASP.NET vous permet de lier n'importe quel contr�le serveur � de simples propri�t�s, collections, expressions et/ou m�thodes. Avec la liaison de donn�es, vous disposez de davantage de flexibilit� lors de l'utilisation des donn�es d'une base de donn�es ou d'autres moyens.

Cet article s'articule autour des rubriques de liaison de donn�es suivantes�:

Principes de base sur la liaison de donn�es
- Syntaxe <%# %>
- Page.DataBind () et Control.DataBind ()
Contr�les de liste li�s aux donn�es
Acc�s aux donn�es
- Classe DataSet
- Class DataReader
Liaison des mod�les de contr�le de liste

Principes de base sur la liaison de donn�es

Syntaxe <%# %>

ASP.NET pr�sente une nouvelle syntaxe d�clarative, <%# %>. Cette syntaxe est la base m�me de l'utilisation de la liaison de donn�es dans une page�.aspx. Toutes les expressions de liaison de donn�es doivent �tre contenues entre ces caract�res. La liste suivante inclut des exemples de liaison de donn�es simples � partir de plusieurs sources�:

Propri�t� simple (syntaxe pour un client)�:
<%# custID %>

Collection (syntaxe pour une commande)�:

<asp:ListBox id="List1" datasource='<%# myArray %>' runat="server">

Expression (syntaxe pour un contact)�:

<%# ( customer.First Name + " " + customer.LastName ) %>

R�sultat de la m�thode (syntaxe pour le restant d�)�:
<%# GetBalance(custID) %>

Dans les exemples pr�c�dents, les balises <% #%> incorpor�es indiquent l'emplacement des informations d'une source de donn�es sp�cifique dans la page�.aspx. L'exemple de liaison de donn�es suivant utilise un contr�le de serveur Web TextBox�:

<asp:textbox id=txt text="<%# custID %>" runat=server />

Pour plus d'informations sur la syntaxe de la liaison de donn�es, reportez-vous � la rubrique suivante dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK) :

Syntaxe d'expression de la liaison de donn�es
http://msdn.microsoft.com/fr-fr/library/bda9bbfx(vs.71).aspx

(http://msdn.microsoft.com/fr-fr/library/bda9bbfx(vs.71).aspx)

Page.DataBind() et Control.DataBind()

Une fois les sources de donn�es sp�cifiques d�termin�es et d�finies pour les objets dans la page�.aspx, vous devez lier les donn�es � ces sources de donn�es. Vous pouvez utiliser la m�thode Page.DataBind ou Control.DataBind pour effectuer cette liaison.

Les deux m�thodes fonctionnent de la m�me fa�on. La principale diff�rence r�side dans le fait que toutes les sources de donn�es sont li�es � leurs contr�les serveur une fois que la m�thode Page.DataBind est appel�e. Aucune donn�e n'est affich�e dans le contr�le tant que vous n'appelez pas de mani�re explicite la m�thode DataBind du contr�le serveur Web ou la m�thode Page.DataBind au niveau page. En g�n�ral, la m�thode Page.DataBind (ou DataBind) est appel�e � partir de l'�v�nement Page_Load.

Pour plus d'informations sur la m�thode DataBind, reportez-vous � la rubrique suivante dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK)�: Control.DataBind Method (M�thode Control.DataBind)
http://msdn.microsoft.com/fr-fr/library/w5e5992d.aspx

(http://msdn.microsoft.com/fr-fr/library/w5e5992d.aspx)

Contr�les de liste li�s aux donn�es

Les contr�les de liste sont des contr�les serveur Web sp�ciaux qui assurent la liaison aux collections. Ils permettent d'afficher des lignes de donn�es dans un format de mod�le personnalis�. Tous les contr�les de liste exposent les propri�t�s DataSource et DataMember, utilis�es pour la liaison aux collections.

Ces contr�les peuvent lier leur propri�t� DataSource � toute collection qui prend en charge l'interface IEnumerable, ICollectionou IListSource.

Contr�le Repeater

Le contr�le Repeater est une liste li�e aux donn�es et bas�e sur des mod�les. Le contr�le Repeater n'a pas de mise en forme propre, autrement dit il ne dispose d'aucun style ni mise en page int�gr�. Par cons�quent, vous devez d�clarer de mani�re explicite la mise en page, la mise en forme, et les balises de style HTML dans les mod�les du contr�le.

Les exemples de code suivants montrent comment vous pouvez utiliser un contr�le de liste, le contr�le Repeater, pour afficher des donn�es�:

REMARQUE�: vous devez modifier les param�tres de la cha�ne de connexion en fonction de votre environnement.

Visual Basic�.NET

<%@ Page Language="vb" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<script runat="server">
Sub Page_Load(sender As Object, e As EventArgs)

   Dim cnn As SqlConnection = New SqlConnection("server=(local);" & _
                                                "database=pubs;Integrated Security=SSPI")
   Dim cmd As SqlDataAdapter = New SqlDataAdapter("select * from authors", cnn)
   Dim ds As DataSet = New DataSet()
   cmd.Fill(ds)
   Repeater1.DataSource = ds
   Repeater1.DataBind()

End Sub
</script>
<html>
<body>
   <form id="Form1" method="post" runat="server">
      <asp:Repeater id="Repeater1" runat="server">
         <ItemTemplate>
         <%# DataBinder.Eval(Container.DataItem,"au_id") %><br>
	 </ItemTemplate>
      </asp:Repeater>
   </form>
</body>
</html>

Visual�C#�.NET

<%@ Page language="c#" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<script runat="server">
void Page_Load(Object sender, EventArgs e) 
{ 
   SqlConnection cnn = new 
       SqlConnection("server=(local);database=pubs;Integrated Security=SSPI"); 
   SqlDataAdapter da = new SqlDataAdapter("select * from authors", cnn); 
   DataSet ds = new DataSet(); 
   da.Fill(ds, "authors"); 
   Repeater1.DataSource = ds.Tables["authors"];
   Repeater1.DataBind();
}
</script>
<html>
<body>
   <form id="WebForm2" method="post" runat="server">
      <asp:Repeater id="Repeater1" runat="server">
         <ItemTemplate>
         <%# DataBinder.Eval(Container.DataItem,"au_id") %><br>
    	 </ItemTemplate>
      </asp:Repeater>
   </form>
</body>
</html>

Visual�J#�.NET

<%@ Page language="VJ#" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

 <script runat="server">
void Page_Load(Object sender, EventArgs e) 
{ 
    SqlConnection cnn = new SqlConnection("server=(local);database=pubs;Integrated
         Security=SSPI"); 
    SqlDataAdapter da = new SqlDataAdapter("select * from authors", cnn); 
    DataSet ds = new DataSet(); 
    da.Fill(ds, "authors"); 
    DataTableCollection dtc = ds.get_Tables();
    int index = dtc.IndexOf("authors");
    Repeater1.set_DataSource(dtc.get_Item(index));
    Repeater1.DataBind();
}
</script>
<html>
<body>
   <form id="WebForm2" method="post" runat="server">
      <asp:Repeater id="Repeater1" runat="server">
         <ItemTemplate>
         <%# DataBinder.Eval(Container.DataItem,"au_id") %><br>
             </ItemTemplate>
      </asp:Repeater>
   </form>
</body>
</html>

Pour plus d'informations sur le contr�le Repeater, reportez-vous � la rubrique suivante dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK)�:

Contr�le serveur Web Repeater
http://msdn.microsoft.com/fr-fr/library/x8f2zez5.aspx

(http://msdn.microsoft.com/fr-fr/library/x8f2zez5.aspx)

Contr�le DataList

La classe DataList est une liste riche en fonctionnalit�s, bas�e sur des mod�les et li�e aux donn�es. Vous pouvez modifier les mod�les pour personnaliser ce contr�le. � la diff�rence du contr�le Repeater, DataList prend en charge le rendu directionnel et peut �ventuellement effectuer un rendu dans une table HTML au moment de l'ex�cution.

Pour plus d'informations sur le contr�le DataList, reportez-vous � la rubrique suivante dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK)�:

Contr�le serveur Web DataList
http://msdn.microsoft.com/fr-fr/library/9cx2f3ks(VS.85).aspx

(http://msdn.microsoft.com/fr-fr/library/9cx2f3ks(VS.85).aspx)

Contr�le DataGrid

Le contr�le DataGrid est une grille compl�te, � plusieurs colonnes et li�e aux donn�es. Pour personnaliser la disposition de colonnes individuelles dans DataGrid, vous pouvez d�finir le type de colonne avec la valeur ��templated�� (bas� sur des mod�les) et modifier les mod�les de la colonne. Le contr�le DataGrid peut s'afficher sans mod�les, ce qui le rend id�al pour les sc�narios de rapport. Le contr�le DataGrid prend �galement en charge la s�lection, la modification, la suppression, la pagination et le tri par colonne et colonnes de bouton.

Pour plus d'informations sur le contr�le DataGrid, reportez-vous � la rubrique suivante dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK)�:

Contr�le serveur Web DataGrid
http://msdn.microsoft.com/fr-fr/library/aa710742(VS.71).aspx

(http://msdn.microsoft.com/fr-fr/library/aa710742(VS.71).aspx)

Acc�s aux donn�es

Cette section explique comment acc�der aux donn�es � partir d'une base de donn�es et comment les lier aux contr�les de liste. Vous pouvez utiliser la classe DataSet ou DataReader pour obtenir des donn�es � partir d'une base de donn�es.

Classe DataSet

Une classe DataSet contient une repr�sentation compl�te des donn�es, y compris la structure de la table, les relations entre les tables, et le classement des donn�es. Les classes DataSet sont assez souples pour stocker toute sorte d'informations d'une base de donn�es dans un fichier XML (Extensible Markup Language). Les classes DataSet sont sans �tat, autrement dit vous pouvez les passer du client au serveur sans bloquer les ressources de connexion du serveur. Le code suivant montre comment utiliser une classe DataSet pour lier les donn�es � un contr�le�:

REMARQUE�: vous devez modifier les param�tres de la cha�ne de connexion en fonction de votre environnement.

Visual Basic .NET

Dim cnn As SqlConnection = New SqlConnection("server=(local);" & _
                                             "database=pubs;Integrated Security=SSPI")
Dim cmd As SqlDataAdapter = New SqlDataAdapter("select * from authors", cnn)
Dim ds As DataSet = New DataSet()
cmd.Fill(ds)
MyRepeater.DataSource = ds
MyRepeater.DataBind()

Visual�C#�.NET

SqlConnection cnn = new SqlConnection("server=(local);
                                       database=pubs;Integrated Security=SSPI"); 
SqlDataAdapter da = new SqlDataAdapter("select * from authors", cnn); 
DataSet ds = new DataSet(); 
da.Fill(ds);
MyRepeater.DataSource = ds;
MyRepeater.DataBind();

Visual�J#�.NET

SqlConnection cnn = new SqlConnection("server=(local);
                                       database=pubs;Integrated Security=SSPI"); 
SqlDataAdapter da = new SqlDataAdapter("select * from authors", cnn); 
DataSet ds = new DataSet(); 
da.Fill(ds); 
MyRepeater.set_DataSource(ds);
MyRepeater.DataBind();

Pour plus d'informations sur la classe DataSet, reportez-vous � la rubrique suivante dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK) �:

Classe DataSet
http://msdn.microsoft.com/fr-fr/library/system.data.dataset(vs.71).aspx

(http://msdn.microsoft.com/fr-fr/library/system.data.dataset(vs.71).aspx)

Classe DataReader

Par contre, si vous devez seulement afficher (sans les modifier) les donn�es � restituer, une classe DataReader peut s'av�rer �tre une meilleure solution. Par exemple, il est pr�f�rable d'utiliser une classe DataReader pour un contr�le DropDownList car DataReader est un curseur de donn�es avant uniquement. Le code suivant montre comment utiliser une classe SqlDataReader pour lier les donn�es � un contr�le�:

Visual Basic .NET

Dim cnn As SqlConnection = New SqlConnection("server=(local);" & _
                                             "database=pubs;Integrated Security=SSPI")
Dim cmd As SqlCommand = New SqlCommand("select * from authors", cnn)

cnn.Open()
MyRepeater.DataSource = cmd.ExecuteReader(CommandBehavior.CloseConnection)
MyRepeater.DataBind()

Visual�C#�.NET

SqlConnection cnn = new SqlConnection("server=(local);
                                       database=pubs;Integrated Security=SSPI");
SqlCommand cmd = new SqlCommand("select * from authors", cnn);

cnn.Open();
MyRepeater.DataSource = cmd.ExecuteReader(CommandBehavior.CloseConnection);
MyRepeater.DataBind();

Visual�J#�.NET

SqlConnection cnn = new SqlConnection("server=(local);
                                       database=pubs;Integrated Security=SSPI"); 

SqlCommand cmd = new SqlCommand("select * from authors", cnn); 

cnn.Open();
MyRepeater.set_DataSource(cmd.ExecuteReader(CommandBehavior.CloseConnection));
MyRepeater.DataBind();

Pour plus d'informations sur la classe SqlDataReader et l'acc�s aux donn�es avec ASP.NET, reportez-vous aux rubriques suivantes dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK) �:

Classe SqlDataReader
http://msdn.microsoft.com/fr-fr/library/system.data.sqlclient.sqldatareader.aspx

(http://msdn.microsoft.com/fr-fr/library/system.data.sqlclient.sqldatareader.aspx)

Developing High-Performance ASP.NET Applications (D�veloppement d'applications � hautes performances�ASP.NET)
http://msdn.microsoft.com/fr-fr/library/5dws599a(vs.71).aspx

(http://msdn.microsoft.com/fr-fr/library/5dws599a(vs.71).aspx)

Liaison des mod�les de contr�le de liste

Vous pouvez utiliser des mod�les dans les contr�les de liste pour lier et personnaliser les enregistrements individuels d'une source de donn�es. Cette section comprend trois m�thodes d�crivant cette proc�dure.

M�thode DataBinder.Eval

Lorsque la source de donn�es fonctionne avec des donn�es qui sont renvoy�es d'une base de donn�es, la source de donn�es peut contenir de nombreuses informations. Vous pouvez utiliser la m�thode g�n�rique DataBinder.Eval pour renvoyer les donn�es. Dans l'exemple de code suivant, le champ ��au_id�� est renvoy� de la source de donn�es de l'objet conteneur�:

<%# DataBinder.Eval(Container.DataItem,"au_id") %>

Pour plus d'informations sur la m�thode DataBinder.Eval, reportez-vous � la rubrique suivante dans la documentation du Kit de d�veloppement logiciel�.NET Framework (SDK) �:

M�thode DataBinder.Eval
http://msdn.microsoft.com/fr-fr/library/4hx47hfe.aspx

(http://msdn.microsoft.com/fr-fr/library/4hx47hfe.aspx)

Cast explicite

Si vous avez besoin de davantage de contr�le, utilisez le cast explicite. Une conversion explicite utilise un mot cl� de conversion de type. Ces mots cl�s se comportent comme des fonctions, si ce n'est que le compilateur g�n�re le code incorpor�. Par cons�quent, l'ex�cution est l�g�rement plus rapide qu'avec un appel de fonction. Les exemples de code suivants utilisent un cast explicite�:

Visual Basic .NET

' DataTable as the DataSource
<%# CType(Container.DataItem, System.Data.DataRowView)("au_id") %>

' DataReader as the DataSource
<%# CType(Container.DataItem, System.Data.Common.DbDataRecord)("au_id") %>

' DataReader as the DataSource
<%# CType(Container.DataItem, System.Data.Common.DbDataRecord)(0) %>

Visual�C#�.NET

// DataTable as the DataSource
<%# ((System.Data.DataRowView)Container.DataItem)["au_id"] %> 

// DataReader as the DataSource
<%# ((System.Data.Common.DbDataRecord)Container.DataItem)["au_id"] %>

// DataReader as the DataSource
<%# ((System.Data.Common.DbDataRecord)Container.DataItem)[0] %>

Visual�J#�.NET

// DataTable as the DataSource
<%# ((System.Data.DataRowView)Container.DataItem)["au_id"] %> 

// DataReader as the DataSource
<%# ((System.Data.Common.DbDataRecord)Container.DataItem)["au_id"] %>

// DataReader as the DataSource
<%# ((System.Data.Common.DbDataRecord)Container.DataItem)[0] %>

Notez que les exemples pr�c�dents utilisent soit DataTable, qui est un sous-ensemble de DataSet, soit DataReader comme source de donn�es.

�v�nement ItemDataBound

Vous pouvez �galement utiliser l'�v�nement ItemDataBound du contr�le pour lier les donn�es. Cet �v�nement se produit lorsqu'un �l�ment est li� au contr�le par les donn�es. L'exemple de code HTML suivant d�finit un contr�le Repeater avec un ItemTemplate�:

<asp:repeater id=rptr runat=server>
   <itemtemplate>
      <asp:label id=lblAuthorID runat=server />
   </itemtemplate>
</asp:repeater>

Les m�thodes suivantes sont requises dans votre page�:

Visual Basic .NET

public Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
  
   'TODO: Retrieve data from a database,
   'and bind the data to a list control.

End Sub

public Sub rptr_OnItemDataBound(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.RepeaterItemEventArgs) Handles rptr.ItemDataBound
   Dim rec As DataRowView
   rec = e.Item.DataItem

   'Make sure that you have the data.
   If Not IsDBNull(rec) Then
      Dim l1 As Label
      l1 = e.Item.FindControl("lblAuthorID")
      l1.Text = rec("au_id").ToString()
   End If
End Sub

Visual�C#�.NET

public void Page_Init(object sender, System.EventArgs e)
{
   rptr.ItemDataBound += new RepeaterItemEventHandler(rptr_OnItemDataBound);
}
public void Page_Load(object sender, System.EventArgs e)
{
   // TODO: Retrieve data from a database,
   // and bind the data to a list control.
}
public void rptr_OnItemDataBound(object sender, RepeaterItemEventArgs e)
{
   System.Data.Common.DbDataRecord rec = (System.Data.Common.DbDataRecord)
                                          e.Item.DataItem;
   if(rec!=null) //Make sure that you have the data.
   {
      Label l1 = (Label)e.Item.FindControl("lblAuthorID");
      l1.Text = rec["au_id"].ToString();
   }
}

Visual�J#�.NET

public void Page_Init(Object sender, System.EventArgs e)
{
            rptr.add_ItemDataBound(new RepeaterItemEventHandler(rptr_OnItemDataBound));
}
private void Page_Load(Object sender, System.EventArgs e)
{
            // TODO: Retrieve data from a database,
            // and bind the data to a list control.
}
public void rptr_OnItemDataBound(Object sender, RepeaterItemEventArgs e)
{
            System.Data.Common.DbDataRecord rec = (System.Data.Common.DbDataRecord)
                                                   e.get_Item().get_DataItem();
            if (rec != null) //Make sure that you have the data.
            {
                        Label l1 = (Label)e.get_Item().FindControl("lblAuthorID");
                        l1.set_Text(((rec.get_Item("au_id")).ToString()));
            }
}

Retour au d�but | Envoyer des commentaires

R�f�rences

Pour plus d'informations g�n�rales sur�ASP.NET, reportez-vous au groupe de discussion MSDN suivant�:

http://www.microsoft.com/france/communautes/webnews/msdn/default.mspx

(http://msdn.microsoft.com/newsgroups/default.aspx?query=microsoft.public.dotnet.framework.aspnet&dg=&cat=en-us-msdn&lang=en&cr=US&pt=&catlist=774F24A2-F71F-425F-AC2B-DC48AB0DA5C9&dglist=&ptlist=&exp=&sloc=en-us)

Retour au d�but | Envoyer des commentaires

Remarque Il s'agit d'un article de � PUBLICATION RAPIDE � r�dig� directement au sein du service de support technique Microsoft. Les informations qui y sont contenues sont fournies en l'�tat, en r�ponse � des probl�mes �mergents. En raison du d�lai rapide de mise � disposition, les informations peuvent contenir des erreurs typographiques et, � tout moment et sans pr�avis, faire l'objet de r�visions. Pour d'autres consid�rations, consultez les Conditions d'utilisation

(http://go.microsoft.com/fwlink/?LinkId=151500)

Retour au d�but | Envoyer des commentaires

Propri�t�s

Num�ro d'article: 307860 - Derni�re mise � jour: vendredi 29 juin 2012 - Version: 1.0

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):

Microsoft ASP.NET 1.0
Microsoft Visual Basic .NET 2002 Initiation
Microsoft Visual C# .NET 2002 Initiation
Microsoft Visual J# .NET 2003 Initiation
Microsoft ASP.NET 1.1
Microsoft Visual Basic .NET 2003 Initiation
Microsoft Visual C# .NET 2003 Initiation

kbarttyperoadmap kbdatabinding kbinfo kbservercontrols KB307860

L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Retour au d�but | Envoyer des commentaires