L'accès aux données est le point crucial de toute application concrète et ASP.NET propose un large éventail de contrôles parfaitement intégrés aux API d'accès aux données managées, fournies dans le Common Language Runtime. Cette section contient plusieurs itérations d'un exemple utilisant le contrôle DataGrid de ASP.NET pour effectuer la liaison aux résultats des requêtes SQL et aux fichiers de données XML. Cette section suppose une certaine connaissance des principes fondamentaux des bases de données, ainsi que du langage des requêtes SQL.

L'accès aux données côté serveur est unique en ce sens que les pages Web sont, à la base, sans état, ce qui présente certains défis complexes lorsque vous tentez d'exécuter des transactions, telles que l'insertion ou la mise à jour d'enregistrements à partir d'un ensemble de données extraites d'une base de données. Comme vous le constaterez dans cette section, le contrôle DataGrid peut vous aider à gérer ces défis, en vous permettant de vous concentrer davantage sur votre logique d'application que sur les détails de la gestion de l'état et des événements.

Le Common Language Runtime fournit un ensemble complet d'API d'accès aux données managées pour le développement d'applications utilisant de nombreuses données. Ces API permettent d'abstraire les données et de les présenter de manière cohérente, peu importe leur source réelle (SQL Server, OLEDB, XML, etc.). La plupart du temps, vous utiliserez essentiellement les trois objets suivants : les connexions, les commandes et les DataSets.

• Une connexion représente une connexion physique à un magasin de données, tel que SQL Server ou un fichier XML.
• Une commande représente une directive à extraire (sélectionner) ou manipuler (insérer, mettre à jour, supprimer) dans le magasin de données.
• Un DataSet représente les données actuellement utilisées par une application. Remarquez que les DataSets sont toujours déconnectés de leur connexion source ainsi que de leur modèle de données et peuvent être modifiées de manière indépendante. Cependant, les modifications apportées à un DataSet peuvent être aisément harmonisées avec le modèle de données d'origine.

Pour lancer une requête Sélection portant sur une base de données SQL, vous devez créer un SqlConnection pour la base de données passant la chaîne de connexion, puis construire un objet SqlDataAdapter qui contient votre instruction de requête. Pour remplir un objet DataSet à l'aide des résultats de la requête, vous devez appeler la méthode Fill de la commande.

SqlConnection myConnection = new SqlConnection("server=(local) \NetSDK;database=pubs;Trusted_Connection=yes"); SqlDataAdapter myCommand = new SqlDataAdapter("select * from Authors", myConnection); DataSet ds = new DataSet(); myCommand.Fill(ds, "Authors"); Dim myConnection As New SqlConnection ("server=(local)\NetSDK;database= pubs;Trusted_Connection=yes") Dim myCommand As New SqlDataAdapter("select * from Authors", myConnection) Dim ds As New DataSet() myCommand.Fill(ds, "Authors") var myConnection:SqlConnection = new SqlConnection("server=(local) \NetSDK;database=pubs; Trusted_Connection=yes"); var myCommand:SqlDataAdapter = new SqlDataAdapter("select * from Authors", myConnection); var ds:DataSet = new DataSet(); myCommand.Fill(ds, "Authors");
C#	VB	JScript

Comme mentionné précédemment dans cette section, l'utilisation d'un DataSet a l'avantage d'offrir une vue déconnectée de la base de données. Vous pouvez manipuler le DataSet dans votre application, puis harmoniser ultérieurement vos modifications avec la base de données. Pour les applications qui s'exécutent sur une longue période, il s'agit souvent de la meilleure approche. Pour les applications Web, vous effectuez généralement des opérations courtes avec chaque demande (généralement dans le seul but d'afficher les données). La plupart du temps, il n'est pas nécessaire de conserver un objet DataSet pendant une série de plusieurs demandes. Dans de telles situations, vous pouvez utiliser un SqlDataReader.

Un SqlDataReader fournit un pointeur avant uniquement, en lecture seule sur des données extraites d'une base de données SQL. Pour utiliser un SqlDataReader, vous devez déclarer un SqlCommand plutôt qu'un SqlDataAdapter. Le SqlCommand expose une méthode ExecuteReader qui retourne un SqlDataReader. Remarquez également que vous devez ouvrir et fermer explicitement le SqlConnection lorsque vous utilisez un SqlCommand. Après un appel à ExecuteReader, le SqlDataReader peut être lié à un contrôle serveur ASP.NET, comme illustré à la section suivante.

SqlConnection myConnection = new SqlConnection ("server=(local)\NetSDK; database=pubs;Trusted_Connection=yes"); SqlCommand myCommand = new SqlCommand("select * from Authors", myConnection); myConnection.Open(); SqlDataReader dr = myCommand.ExecuteReader(); ... myConnection.Close(); Dim myConnection As SqlConnection = New SqlConnection ("server=(local)\NetSDK; database=pubs;Trusted_Connection=yes") Dim myCommand As SqlCommand = New SqlCommand("select * from Authors", myConnection) myConnection.Open() Dim dr As SqlDataReader = myCommand.ExecuteReader() ... myConnection.Close() var myConnection:SqlConnection = new SqlConnection("server=(local) \NetSDK;database=pubs;Trusted_Connection=yes"); var myCommand:SqlCommand = new SqlCommand("select * from Authors", myConnection); myConnection.Open(); var dr : SqlDataReader; dr = myCommand.ExecuteReader(); ... myConnection.Close();
C#	VB	JScript

Lorsque vous exécutez des commandes qui n'exigent pas le retour de données, telles que des insertions, des mises à jour et des suppressions, vous devez également utiliser un SqlCommand. La commande est lancée en appelant une méthode ExecuteNonQuery, qui retourne le nombre de lignes affectées. Remarquez que la connexion doit être explicitement ouverte lorsque vous utilisez le SqlCommand. Le SqlDataAdapter traite automatiquement l'ouverture de session à votre intention.

SqlConnection myConnection = new SqlConnection("server= (local)\NetSDK;database= pubs;Trusted_Connection=yes"); SqlCommand myCommand = new SqlCommand( "UPDATE Authors SET phone='(800) 555-5555' WHERE au_id = '123-45-6789'", myConnection); myCommand.Connection.Open(); myCommand.ExecuteNonQuery(); myCommand.Connection.Close(); Dim myConnection As New SqlConnection("server =(local)\NetSDK;database= pubs;Trusted_Connection=yes") Dim myCommand As New SqlCommand( _ "UPDATE Authors SET phone='(800) 555-5555' WHERE au_id = '123-45-6789'", _ myConnection) myCommand.Connection.Open() myCommand.ExecuteNonQuery() myCommand.Connection.Close() var myConnection:SqlConnection = new SqlConnection("server=(local) \NetSDK;database=pubs;Trusted_Connection=yes"); var myCommand:SqlCommand = new SqlCommand( "UPDATE Authors SET phone='(800) 555-5555' WHERE au_id = '123-45-6789'", myConnection); myCommand.Connection.Open(); myCommand.ExecuteNonQuery(); myCommand.Connection.Close();
C#	VB	JScript

public void MyDataGrid_Edit(Object sender, DataGridCommandEventArgs E) { MyDataGrid.EditItemIndex = (int)E.Item.ItemIndex; BindGrid(); } Public Sub MyDataGrid_Edit (sender As Object, E As DataGridCommandEventArgs) MyDataGrid.EditItemIndex = E.Item.ItemIndex BindGrid() End Sub public function MyDataGrid_Edit(sender:Object, E:DataGridCommandEventArgs) : void { MyDataGrid.EditItemIndex = int(E.Item.ItemIndex); BindGrid(); }
C#	VB	JScript

Si une ligne du DataGrid est modifiée, EditCommandColumn restitue les liens Update et Cancel. Si le client sélectionne Cancel, réaffectez simplement à EditItemIndex la valeur -1. Par contre, si le client sélectionne Update, vous devez exécuter votre commande de mise à jour sur la base de données. Pour exécuter une requête de mise à jour, vous devez connaître la clé primaire de la base de données correspondant à la ligne que vous souhaitez mettre à jour. Dans ce but, DataGrid expose une propriété DataKeyField à laquelle vous pouvez affecter le nom de champ clé primaire. Dans le gestionnaire d'événements associé à UpdateCommand, vous pouvez récupérer le nom de la clé à partir de la collection DataKeys de DataGrid. Pour indexer dans cette collection, utilisez l'ItemIndex de l'événement, comme le montre l'exemple suivant.

myCommand.Parameters["@Id"].Value = MyDataGrid.DataKeys[(int)E.Item.ItemIndex]; myCommand.Parameters("@Id") .Value = MyDataGrid.DataKeys (CType(E.Item.ItemIndex, Integer)) myCommand.Parameters["@Id"].Value = MyDataGrid.DataKeys[int(E.Item.ItemIndex)];
C#	VB	JScript

À la fin du gestionnaire d'événements Update, réaffectez à EditItemIndex la valeur -1. L'exemple suivant illustre le fonctionnement de ce code.

VB DataGrid6.aspx

Le problème de l'exemple précédent réside dans le fait que le champ clé primaire (au_id) est également restitué sous la forme d'une zone de texte si une ligne est modifiable. Vous ne souhaitez pas que le client modifie cette valeur, car vous en avez besoin pour déterminer la ligne à mettre à jour dans la base de données. Heureusement, vous pouvez désactiver la restitution sous forme de zone de texte pour cette colonne en spécifiant exactement l'aspect de chaque colonne pour la ligne modifiable. Dans ce but, définissez chaque ligne dans la collection Columns du DataGrid, à l'aide du contrôle BoundColumn, pour assigner des champs de données à chaque colonne. Cette technique permet de contrôler totalement l'ordre des colonnes, ainsi que leur propriété ReadOnly. Pour la colonne au_id, affectez à la propriété ReadOnly la valeur true. Si une ligne est en mode édition, cette colonne continue à être restituée sous la forme d'une étiquette. L'exemple suivant illustre cette technique :

VB DataGrid7.aspx

Les contrôles BoundColumn ne sont pas les seuls contrôles que vous pouvez définir dans la collection Columns du DataGrid. Vous pouvez aussi spécifier un TemplateColumn afin de contrôler totalement le contenu de la colonne. Le modèle est simplement un contenu arbitraire. Vous pouvez restituer ce que vous souhaitez, y compris des contrôles serveur, dans les colonnes du DataGrid. L'exemple suivant illustre l'utilisation du contrôle TemplateColumn pour restituer la colonne « State » sous la forme d'une liste déroulante et la colonne « Contract » sous la forme d'un HtmlControl de case à cocher. La syntaxe de liaison de données ASP.NET est utilisée pour sortir la valeur du champ de données au sein du modèle. Remarquez la complexité de la logique permettant de forcer la liste déroulante et la case à cocher à refléter l'état des données dans la ligne.

VB DataGrid8.aspx

Comme vous pouvez placer un HtmlControl de liste déroulante ou de case à cocher dans un TemplateColumn, vous pouvez également insérer d'autres contrôles à cet endroit. L'exemple suivant ajoute des contrôles Validator aux colonnes afin de vérifier l'entrée du client avant de tenter d'exécuter la mise à jour.

Sur la page de détails, vous extrayez l'argument Querystring et exécutez une sélection de jointure pour obtenir les détails à partir de la base de données. L'exemple suivant illustre ce scénario :

Vous pouvez créer des procédures stockées qui acceptent également des paramètres. Par exemple :

CREATE Procedure LoadPersonalizationSettings 
(@UserId varchar(50)) AS
    SELECT * FROM Personalization
 WHERE UserID=@UserId
    return
GO

L'utilisation d'une procédure stockée à partir d'une page ASP.NET s'inscrit dans le prolongement de ce que vous avez appris jusqu'ici à propos de l'objet SqlCommand. CommandText est simplement le nom de la procédure stockée, et non le texte de requête ad hoc. Pour indiquer à SqlCommand que CommandText est une procédure stockée, définissez la propriété CommandType.

myCommand.SelectCommand.CommandType = CommandType.StoredProcedure; myCommand.SelectCommand.CommandType = CommandType.StoredProcedure myCommand.SelectCommand.CommandType = CommandType.StoredProcedure;
C#	VB	JScript

L'exemple suivant illustre un appel à une procédure stockée pour remplir le DataSet.

VB DataGrid14.aspx

Les paramètres des procédures stockées sont passés de la même manière que pour les requêtes ad hoc, comme illustré dans les exemples suivants.

VB DataGrid15.aspx

Chaque section TableName correspond à une ligne unique du tableau. L'exemple suivant illustre la lecture du schéma et des données à partir d'un fichier XML à l'aide de la méthode ReadXml du DataSet. Remarquez qu'après leur lecture dans le DataSet, les données ne peuvent plus être distinguées des données SQL. Le DataGrid se lie à celles-ci de la même manière, comme illustré dans l'exemple suivant.

VB DataGrid17.aspx

Vous pouvez également lire les données et le schéma séparément, à l'aide des méthodes ReadXmlData et ReadXmlSchema du DataSet, de la manière illustrée dans l'exemple suivant.

VB DataGrid18.aspx

Le DataSet prend en charge non seulement les méthodes de lecture des données XML, mais également leur écriture. L'exemple suivant implémente un outil permettant de sélectionner des données SQL et d'écrire le résultat sous la forme de données XML ou de texte de schéma.