Procédure pas à pas : activation de Dynamic Data dans des contrôles liés aux données ASP.NET

Démarrez Visual Studio.

Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.

La boîte de dialogue Nouveau projet s'affiche.

Sous Modèles installés, dans le volet gauche, sélectionnez Visual Basic ou Visual C#, puis sélectionnez Web.

Sous Modèles installés, sélectionnez Application Web ASP.NET.

Dans la zone Emplacement, entrez le nom du dossier dans lequel vous souhaitez conserver l'application Web. Par exemple, entrez le nom de dossier C:\WebApplications\EnableDynamicData.

Cliquez sur OK.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le dossier App_Data, puis cliquez sur Ajouter un élément existant.

Dans la boîte de dialogue Ajouter un élément existant, entrez l'emplacement de stockage du fichier de base de données AdventureWorksLT (AdventureWorksLT.mdf), puis cliquez sur Ajouter.

Cette procédure crée une copie du fichier de base de données dans le projet. Pour plus d'informations, consultez Comment : établir une connexion avec la base de données AdventureWorksLT à l'aide d'un fichier .MDF.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Ajouter.

Cliquez sur Nouvel élément.

Sous Modèles installés, dans le volet gauche, sélectionnez Données.

Dans le volet central, cliquez sur Classes LINQ to SQL.

Dans la zone Nom, entrez le nom AdventureWorksLT.dbml pour le modèle de base de données.

Cliquez sur Ajouter.

Le Concepteur Objet/Relationnel s'affiche. Pour plus d'informations, consultez Concepteur Objet/Relationnel (Concepteur O/R).

Dans le Concepteur Objet/Relationnel, cliquez sur le lien Explorateur de serveurs.

Dans l'Explorateur de serveurs, sous Connexions de données, développez le nœud AdventureWorksLT_Data.mdf, puis le nœud Tables.

Sélectionnez toutes les tables et faites-les glisser dans la fenêtre Concepteur O/R.

Dans le diagramme affiché, sélectionnez toutes les colonnes de la table SalesOrdersDetail.

Dans la fenêtre Propriétés associée, affectez à la propriété Vérification des mises à jour la valeur Jamais.

Fermez l'Explorateur de serveurs.

Enregistrez et fermez le fichier AdventureWorksLT.dbml.

Vous avez créé le modèle de données qui représente la base de données AdventureWorksLT.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Ajouter.

Cliquez sur Nouvel élément.

Sous Modèles installés, dans le volet gauche, cliquez sur Code.

Dans le volet central, cliquez sur Fichier de code.

Dans la zone Nom, entrez ProcessingOrderDetails.vb ou ProcessingOrderDetails.cs, puis cliquez sur Ajouter.

Copiez le code suivant dans la nouvelle classe, en remplaçant tout code déjà présent dans le fichier.

Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web

Namespace EnableDynamicData
  Public Class ProcessingOrderDetails
    Public Function GetSalesOrderDetails() As IEnumerable( _
      Of SalesOrderDetail)
      Using db As New AdventureWorksLTDataContext()
        Return db.SalesOrderDetails.ToList()
      End Using
    End Function

    Public Sub Update(ByVal p As SalesOrderDetail)
      Using db As New AdventureWorksLTDataContext()
        db.SalesOrderDetails.Attach(p, True)
        db.SubmitChanges()
      End Using
    End Sub
  End Class
End Namespace

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;

namespace EnableDynamicData
{
  public class ProcessingOrderDetails
  {
    public IEnumerable<SalesOrderDetail> GetSalesOrderDetails()
    {
      using (AdventureWorksLTDataContext db = 
         new AdventureWorksLTDataContext())
      {
        return db.SalesOrderDetails.ToList();
       }
    }

    public void Update(SalesOrderDetail p)
    {
      using (AdventureWorksLTDataContext db = 
        new AdventureWorksLTDataContext())
        {
          db.SalesOrderDetails.Attach(p, true);
          db.SubmitChanges();
        }
    }
  }
}

La classe contient les méthodes suivantes :

• GetSalesOrderDetails. Cette méthode retourne les lignes de données de la table SalesOrderDetail. Cette méthode instancie l'objet de contexte de base de données, puis utilise la classe SalesOrderDetails pour obtenir la collection de lignes.

• Update. Cette méthode modifie une valeur de colonne dans la table SalesOrderDetail. La méthode instancie l'objet de contexte de base de données, puis soumet les modifications apportées dans la table SalesOrderDetail à la base de données.

Enregistrez et fermez le fichier.

Dans le menu Générer, cliquez sur Générer EnableDynamicData (ou sur le nom utilisé pour l'application Web) pour générer la solution.

Cela rend l'objet métier disponible pour la procédure suivante.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Ajouter.

Cliquez sur Nouvel élément.

Sous Modèles installés, dans le volet gauche, cliquez sur Web.

Dans le volet central, cliquez sur Web Form.

Dans la zone Nom entrez EnableDynamicData.aspx, puis cliquez sur Ajouter.

Basculez en mode Design.

À partir du groupe Données de la Boîte à outils, ajoutez un contrôle ObjectDataSource à la page.

Dans le menu Tâches ObjectDataSource, cliquez sur Configurer la source de données.

La boîte de dialogue Choisir un objet métier s'affiche.

Dans la liste Choisissez votre objet métier, sélectionnez la classe ProcessingOrderDetails que vous avez créée lors de la procédure précédente.

Cliquez sur Suivant.

La boîte de dialogue Définir les méthodes de données s'affiche.

Dans la liste Choisissez une méthode dans le volet à onglets Sélectionner, sélectionnez la méthode GetSalesOrderDetails.

Cliquez sur l'onglet Mettre à jour.

Dans la liste Choisissez une méthode dans le volet à onglets Mettre à jour, sélectionnez la méthode Update.

Cliquez sur Terminer.

Vous avez configuré le contrôle de source de données de façon à utiliser la classe ProcessingOrderDetails qui interagit avec la base de données via le modèle de données.

À partir du groupe Données de la Boîte à outils, ajoutez un contrôle GridView à la page.

Dans le menu Tâches GridView, dans la liste Choisir la source de données, sélectionnez ObjectDataSource1.

Il s'agit de l'ID du contrôle ObjectDataSource que vous avez créé lors d'une procédure précédente.

Activez la pagination, la modification et la sélection.

Basculez en mode Source.

Dans le contrôle GridView, dans l'élément Columns, supprimez tous les contrôles DataBoundField qui ont été générés automatiquement. (Conservez l'élément CommandField.)

Activez la génération automatique de colonnes en affectant à l'attribut AutoGenerateColumns la valeur true, comme indiqué dans l'exemple suivant :

<asp:GridView ID="GridView1" runat="server" AllowPaging="True" 
  DataSourceID="ObjectDataSource1" AutoGenerateColumns="True" >
    <Columns>
      <asp:CommandField 
        ShowEditButton="True" ShowSelectButton="True" /> 
    </Columns>
</asp:GridView>

Enregistrez et fermez le fichier EnableDynamicData.aspx.

Ouvrez le fichier de classe EnableDynamicData.aspx.vb ou EnableDynamicData.aspx.cs.

Ajoutez la référence aux espaces de noms System.Web.DynamicData comme indiqué dans l'exemple suivant :

Imports System.Web.DynamicData

using System.Web.DynamicData

Dans la méthode Page_Init, activez Dynamic Data pour le contrôle GridView comme indiqué dans l'exemple suivant :

Private Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Init
    GridView1.EnableDynamicData(GetType(SalesOrderDetail))
End Sub

protected void Page_Init()
  {
    GridView1.EnableDynamicData(typeof(SalesOrderDetail));
  }

Enregistrez et fermez le fichier.

Régénérez l'application.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la page EnableDynamicData.aspx, puis cliquez sur Afficher dans le navigateur.

Le navigateur affiche une page qui montre la table SalesOrderDetail.

Vérifiez que les champs de données SalesOrderDetails corrects sont affichés.

Sur une ligne quelconque, cliquez sur Modifier et, pour la colonne UnitPrice, entrez une valeur non numérique.

Sur la même ligne, cliquez sur Mettre à jour.

Dynamic Data affiche un message d'erreur qui vous signale que le champ UnitPrice doit être une valeur décimale. Remarquez que l'interface utilisateur utilisée pour la modification est basée sur le modèle Dynamic Data par défaut.

Sur la même ligne, cliquez sur Annuler.

Sur une ligne quelconque, cliquez sur Modifier, puis modifiez la colonne OrderQty en une valeur inférieure ou égale à la valeur entière maximale (32767) autorisée par la base de données.

Sur la même ligne, cliquez sur Mettre à jour.

Dynamic Data met à jour la base de données. Étant donné que vous avez entré une valeur valide, la validation Dynamic Data des données réussit.

Sur une ligne quelconque, cliquez sur Modifier, puis modifiez la colonne OrderQty en une valeur supérieure à la valeur entière maximale (32767) autorisée par la base de données.

Sur la même ligne, cliquez sur Mettre à jour.

Dynamic Data affiche un message d'erreur qui signale que vous avez entré une valeur non valide.

Sur la même ligne, cliquez sur Annuler.

Cela montre que les fonctionnalités Dynamic Data ont été intégrées au contrôle GridView et qu'il utilise les informations de métadonnées obtenues à partir du schéma de base de données. La validation fait partie des fonctionnalités que votre application a héritée de Dynamic Data.

Fermez le navigateur.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Ajouter une référence.

La boîte de dialogue Ajouter une référence s'affiche.

Cliquez sur l'onglet .NET.

Dans la liste, sélectionnez System.ComponentModel.DataAnnotations.

Cliquez sur OK.

Ouvrez le fichier EnableDynamicData.aspx.vb ou EnableDynamicData.aspx.cs.

Copiez le code suivant dans ce fichier, en remplaçant tout code déjà présent.

Imports System.ComponentModel.DataAnnotations

Namespace EnableDynamicData
  <MetadataType(GetType(SalesOrderDetailMetadata))> _
  Partial Public Class SalesOrderDetail
    Public Class SalesOrderDetailMetadata
      Private privateUnitPrice As String
      <Required()> _
      Public Property UnitPrice() As String
        Get
          Return privateUnitPrice
        End Get
        Set(ByVal value As String)
          privateUnitPrice = value
        End Set
      End Property

      Private privateOrderQty As Decimal
        <Range(0, 100)> _
        Public Property OrderQty() As Decimal
          Get
            Return privateOrderQty
          End Get
          Set(ByVal value As Decimal)
            privateOrderQty = value
          End Set
        End Property
    End Class
  End Class

End Namespace

using System.ComponentModel.DataAnnotations;

namespace EnableDynamicData
{
  [MetadataType(typeof(SalesOrderDetailMetadata))]
  public partial class SalesOrderDetail
  {
    public class SalesOrderDetailMetadata
    {
      [Required]
      public string UnitPrice { get; set; }

      [Range(0, 100)]
      public decimal OrderQty { get; set; }

    }
  }

     
}

Ce code crée deux classes : une classe partielle nommée SalesOrderDetail et une classe à l'intérieur de celle nommée SalesOrderDetailMetadata.

Ces classes étendent le modèle de données et vous permettent d'effectuer les tâches suivantes :

• Ajoutez des métadonnées au champ de données UnitPrice pour interdire les valeurs Null. (La base de données AdventureWorks autorise les valeurs Null pour le champ de données UnitPrice.) Dynamic Data renvoie un message d'erreur lorsque l'utilisateur essaie d'entrer une valeur Null.

• Ajoutez des métadonnées au champ de données OrderQty pour définir une plage autorisée. La base de données AdventureWorks n'a pas de limites de plage pour le champ de données OrderQty. Dynamic Data renvoie un message d'erreur lorsque l'utilisateur essaie d'entrer une valeur située en dehors de la plage autorisée.

L'utilisation de classes partielles de cette façon offre un moyen flexible de modifier le comportement du modèle de données sans modifier directement le modèle de données.

Enregistrez et fermez le fichier.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la page EnableDynamicData.aspx, puis sélectionnez Afficher dans le navigateur.

Le navigateur affiche une page qui montre la table SalesOrderDetails.

Sur une ligne quelconque, cliquez sur Modifier et effacez la valeur de colonne UnitPrice.

Sur la même ligne, cliquez sur Mettre à jour.

Dynamic Data affiche un message d'erreur qui vous signale que le champ UnitPrice est obligatoire. Cela montre que la validation Dynamic Data a été intégrée au contrôle GridView et qu'il utilise les informations de métadonnées personnalisées que vous avez fournies.

Sur la même ligne, cliquez sur Annuler.

Sur une ligne quelconque, cliquez sur Modifier, puis modifiez la colonne OrderQty en une valeur située dans la plage autorisée, telle que 25.

Sur la même ligne, cliquez sur Mettre à jour.

Dynamic Data met à jour la base de données. Étant donné que vous avez entré une valeur valide, la validation des données réussit.

Sur ligne quelconque, cliquez sur Modifier et, pour la colonne OrderQty, entrez une valeur située en dehors de la plage autorisée, telle que 250.

Sur la même ligne, cliquez sur Mettre à jour.

Dynamic Data affiche un message d'erreur qui signale que la valeur du champ de données doit être comprise entre 0 et 100. Cela montre que la validation Dynamic Data a été intégrée au contrôle GridView à l'aide des informations de métadonnées personnalisées.

Sur la même ligne, cliquez sur Annuler.