Procedura dettagliata: eseguire il mapping dell'ereditarietà tabella per gerarchia

In questo argomento viene illustrato come implementare l'ereditarietà tabella per gerarchia modificando il modello concettuale in un modello EDM (Entity Data Model). L'ereditarietà tabella per gerarchia utilizza una tabella di database per gestire i dati relativi a tutti i tipi di entità in una gerarchia di ereditarietà. Per ulteriori informazioni sull'implementazione dell'ereditarietà con un modello EDM, vedere Ereditarietà (EDM).

In questa procedura dettagliata verrà implementata l'ereditarietà tabella per gerarchia modificando il modello EDM (Entity Data Model) utilizzato nell'applicazione CourseManager. Per ulteriori informazioni, vedere la sezione Prerequisiti più avanti in questo argomento.

Nel modello EDM dell'applicazione CourseManager il tipo di entità Person dispone di due proprietà, HireDate e EnrollmentDate, che possono appartenere ai nuovi tipi di entità (Instructor e Student rispettivamente) che ereditano da Person. L'implementazione dell'ereditarietà tabella per gerarchia di questo caso specifico viene riepilogata nei passaggi seguenti. Le procedure dettagliate includono una descrizione più particolareggiata.

1. Creare due nuovi tipi di entità, Instructor e Student.

2. Impostare il tipo di base per ogni nuovo tipo di identità su Person.

3. Spostare la proprietà HireDate da Person a Instructor e la proprietà EnrollmentDate da Person a Student.

4. Convertire il tipo di entità Person in un tipo astratto.

5. Eseguire il mapping del tipo di entità Instructor alla tabella Person con due condizioni: HireDate Is Not Null e EnrollmentDate Is Null.

6. Eseguire il mapping del tipo di entità Student alla tabella Person con due condizioni: EnrollmentDate Is Not Null e HireDate Is Null.

Prerequisiti

Per completare questa procedura dettagliata, è necessario compilare l'applicazione CourseManager. Per ulteriori informazioni e istruzioni, vedere la Guida rapida di Entity Framework. Dopo avere compilato questa applicazione, si procede alla modifica del modello EDM attraverso l'implementazione dell'ereditarietà tabella per gerarchia. La funzionalità dell'applicazione viene quindi estesa per visualizzare l'iscrizione a un corso selezionato.

Nota
Poiché in molte procedure dettagliate di questa documentazione viene utilizzata l'applicazione CourseManager come punto di partenza, è consigliabile utilizzare una copia di tale applicazione anziché modificare il codice di CourseManager originale.

In questa procedura dettagliata si presuppone che il lettore disponga di una competenza di base di Visual Studio, .NET Framework e della programmazione in Visual C# o Visual Basic.

Implementazione dell'ereditarietà tabella per gerarchia

In questa procedura verrà modificata la parte concettuale del modello EDM SchoolModel per implementare l'ereditarietà tabella per gerarchia.

Per implementare l'ereditarietà tabella per gerarchia

1. Aprire la soluzione CourseManager in Visual Studio.

2. In Esplora soluzioni fare doppio clic sul file School.edmx.

   Il file School.edmx verrà aperto in ADO.NET Entity Data Model Designer (Entity Designer).

3. Fare clic con il pulsante destro del mouse in un spazio vuoto dell'area di progettazione di Entity Designer, scegliere Aggiungi, quindi fare clic su Entità.

   Verrà visualizzata la finestra di dialogo Nuova entità.

4. Digitare Instructor per Nome entità e selezionare Person dall'elenco a discesa per il Tipo di base.

5. Fare clic su OK.

   Nell'area di progettazione verrà creato e visualizzato un nuovo tipo di entità.

6. Ripetere i passaggi da 3 a 5, ma digitare Student per Nome entità nel secondo passaggio.

   Sono ora disponibili due nuovi tipi di entità, Instructor e Student, visualizzati nell'area di progettazione. Le frecce puntano dai nuovi tipi di entità al tipo di entità Person. Questo indica che Person è il tipo di base per i nuovi tipi di entità.

7. Fare clic con il pulsante destro del mouse sulla proprietà HireDate (in Proprietà scalari) del tipo di entità Person. Scegliere Taglia.

8. Fare clic con il pulsante destro del mouse su Proprietà scalari del tipo di entità Instructor e scegliere Incolla.

9. Fare clic con il pulsante destro del mouse sulla proprietà HireDate e scegliere Proprietà.

10. Nella finestra Proprietà impostare la proprietà Nullable su false.

11. Ripetere i passaggi da 7 a 10, ma tagliare la proprietà EnrollmentDate del tipo di entità Person e incollarla nel tipo di entità Student.

12. Selezionare il tipo di entità Person. Nella finestra Proprietà impostare la proprietà Abstract su true.

    Verrà visualizzata una finestra di messaggio in cui viene indicato che la definizione di un tipo di entità come astratto determinerà la rimozione di tutti i mapping di funzione esistenti per tale tipo. Fare clic su OK.

    Nota
    Non è necessario utilizzare i tipi astratti per modellare gli scenari tabella per gerarchia in generale. I tipi astratti sono utilizzati in questo esempio per dimostrarne l'utilizzo in un modello EDM.

    Nota
    Gli altri passaggi di questa procedura presuppongono che la finestra Dettagli Mapping sia aperta. Se la finestra non è visibile, fare clic con il pulsante destro del mouse sull'area di progettazione e scegliere Dettagli Mapping.

13. Selezionare il tipo di entità Instructor e fare clic su <Aggiungi tabella o visualizzazione> nella finestra Dettagli Mapping.

    Il campo <Aggiungi tabella o visualizzazione> diventa un elenco a discesa di tabelle o visualizzazioni a cui è possibile mappare l'entità selezionata.

14. Selezionare Person dall'elenco a discesa.

    La finestra Dettagli Mapping viene aggiornata con i mapping di colonne predefiniti e con un'opzione per l'aggiunta di una condizione.

15. Fare clic su <Aggiungere una Condition>.

    Il campo <Aggiungere una Condition> diventa un elenco a discesa di colonne in cui è possibile impostare le condizioni.

16. Selezionare HireDate dall'elenco a discesa.

    Viene visualizzato un altro campo <Aggiungere una Condition>.

17. Nella colonna Operatore della finestra Dettagli Mapping selezionare Is dall'elenco a discesa.

18. Nella colonna Proprietà/Valore selezionare Not Null.

19. Fare clic su <Aggiungere una Condition>.

20. Selezionare EnrollmentDate nell'elenco a discesa.

21. Nella colonna Operatore selezionare Is nell'elenco a discesa.

22. Nella colonna Proprietà/Valore selezionare Null.

    Nota
    Se un valore specificato in Proprietà/Valore è utilizzato in una condizione, non può essere anche una proprietà di entità, a meno che nella condizione non venga utilizzato un operatore di confronto Is Null o Is Not Null.

23. Ripetere i passaggi da 13 a 22 per il tipo di entità Student, ma creare le condizioni HireDate Is Null e EnrollmentDate Is Not Null.

A questo punto l'ereditarietà tabella per gerarchia risulta implementata.

Costruzione dell'interfaccia utente

A questo punto verrà aggiunto un pulsante al form CourseViewer che carica e visualizza il form Enrollment. Dopodiché, verranno aggiunti due controlli ComboBox e un controllo ListBox al form Enrollment. Il primo controllo ComboBox consente di selezionare un reparto. Il secondo controllo ComboBox consente di selezionare un corso in base al reparto selezionato nel primo ComboBox. Nel controllo ListBox viene visualizzato un elenco di studenti e docenti per il corso selezionato.

Per costruire l'interfaccia utente

1. Fare clic con il pulsante destro del mouse sul progetto CourseManager in Esplora soluzioni, scegliere Aggiungi, quindi selezionare Nuovo elemento.

   Verrà visualizzata la finestra di dialogo Aggiungi nuovo elemento.

2. Selezionare Windows Form, impostare il nome del form su Enrollment.vb o Enrollment.cs, a seconda del linguaggio utilizzato, e fare clic su Aggiungi.

   Un nuovo form verrà aggiunto al progetto e aperto nella finestra di progettazione dei form. Il nome del form viene impostato su Enrollment, mentre il testo viene impostato su Enrollment.

3. Trascinare un controllo ComboBox dalla casella degli strumenti al form e impostarne il nome su departmentList nella finestra Proprietà.

4. Trascinare un altro controllo ComboBox nel form e impostarne il nome su courseList.

5. Trascinare un controllo Listbox dalla casella degli strumenti al form. Impostarne il nome su studentList nella finestra Proprietà.

6. In Esplora soluzioni fare doppio clic su CourseViewer.cs o su CourseViewer.vb.

   Verrà aperta la visualizzazione Progettazione del form CourseViewer.

7. Trascinare un controllo Button dalla casella degli strumenti al form CourseViewer.

8. Nella finestra Proprietà impostare il nome del pulsante su viewEnrollment e impostare il testo del pulsante su View Enrollment.

9. Fare doppio clic sul pulsante viewEnrollment.

   Verrà visualizzato il file code-behind per il form CourseViewer.

10. Aggiungere il codice seguente al gestore eventi viewEnrollment_click:

    Dim enrollmentForm As New Enrollment()
    enrollmentForm.Visible = True
    

    Enrollment enrollmentForm = new Enrollment();
    enrollmentForm.Visible = true;
    

L'interfaccia utente è ora completa.

Esecuzione di query sul modello EDM

In questa procedura verrà eseguita una query sul modello EDM e verranno associati i risultati ai controlli Windows Form. Per ulteriori informazioni sull'associazione di oggetti ai controlli, vedere Associazione di oggetti ai controlli (Entity Framework).

Per eseguire query sul modello EDM

1. Fare doppio clic sul form Enrollment dopo averlo aperto nella finestra di progettazione dei form.

   Verrà visualizzato il file code-behind per il form Enrollment.

2. Aggiungere le istruzioni seguenti using (C#) o Imports (Visual Basic) per fare riferimento allo spazio dei nomi EDM.

   Imports System.Data.Objects
   Imports System.Data.Objects.DataClasses
   

   using System.Data.Objects;
   using System.Data.Objects.DataClasses;
   

3. Aggiungere una proprietà alla classe Enrollment che rappresenta il contesto dei dati:

   ' Create an ObjectContext instance based on SchoolEntity.
   Private schoolContext As SchoolEntities
   

   // Create an ObjectContext instance based on SchoolEntity.
   private SchoolEntities schoolContext;
   

4. Nel gestore eventi Enrollment_Load aggiungere codice per inizializzare il contesto dell'oggetto e associare il controllo ComboBox a una query che restituisce informazioni su tutti i reparti e i corsi correlati.

   ' Initialize the ObjectContext.
   schoolContext = New SchoolEntities()
   
   ' Define a query that returns all Department objects and 
   ' related Course objects, ordered by name.
   Dim departmentQuery As ObjectQuery(Of Department) = _
       schoolContext.Department.Include("Course") _
       .OrderBy("it.Name")
   
   ' Bind the ComboBox control to the query, which is 
   ' executed during data binding.
   Me.departmentList.DataSource = departmentQuery _
   .Execute(MergeOption.OverwriteChanges)
   Me.departmentList.DisplayMember = "Name"
   

       // Initialize the ObjectContext.
       schoolContext = new SchoolEntities();
   
       // Define a query that returns all Department objects
       // and related Course objects, ordered by name.
       ObjectQuery<Department> departmentQuery =
           schoolContext.Department.Include("Course")
                                   .OrderBy("it.Name");
   
       // Bind the ComboBox control to the query, which is
       // executed during data binding.
       this.departmentList.DataSource = departmentQuery
   .Execute(MergeOption.OverwriteChanges);
       this.departmentList.DisplayMember = "Name";
   

5. Tornare alla visualizzazione Progettazione del form Enrollment e fare doppio clic sul controllo departmentListComboBox.

   Il gestore eventi departmentList_SelectedIndexChanged viene creato nel file code-behind.

6. Aggiungere codice al gestore eventi per associare il controllo courseListComboBox alle proprietà Course dell'oggetto Department selezionato.

   ' Get the object for the selected department
   Dim department As Department = CType(Me.departmentList _
           .SelectedItem, Department)
   
   ' Bind the ComboBox control Course properties of
   ' the selected Department.
   courseList.DataSource = department.Course
   courseList.DisplayMember = "Title"
   

   // Get the object for the selected department.
   Department department =
           (Department)this.departmentList.SelectedItem;
   
   // Bind the ComboBox control Course properties of 
   // the selected Department.
   courseList.DataSource = department.Course;
   courseList.DisplayMember = "Title";
   

7. Tornare alla visualizzazione Progettazione del form Enrollment e fare doppio clic sul controllo courseListComboBox.

   Il gestore eventi courseList_SelectedIndexChanged viene creato nel file code-behind.

8. Aggiungere codice al gestore eventi per visualizzare un elenco di studenti nel controllo ListBox.

   Me.studentList.Items.Clear()
   
   ' Get the CourseID from the selected Course.
   Dim course As Course = CType(Me.courseList.SelectedItem,  _
        Course)
   Dim courseId As Integer = course.CourseID
   
   ' Get all CourseGrade objects for the supplied CourseID
   Dim studentQuery As Course = schoolContext.Course.Where _
        ("it.CourseID = @courseID", New ObjectParameter _
         ("courseID", courseId)).Include("CourseGrade"). _
         FirstOrDefault()
   
   ' Get all students for each CourseGrade
   For Each cg As CourseGrade In studentQuery.CourseGrade
       cg.PersonReference.Load()
       studentList.Items.Add(cg.Person.LastName + ", " + _
                           cg.Person.FirstName)
   Next
   
   studentList.Items.Add(" ")
   
   ' Get all Instructor types for the supplied CourseID
   Dim instructorQuery As Course = schoolContext.Course. _
        Where("it.CourseID = @courseID", New ObjectParameter _
              ("courseID", courseId)).Include("Person") _
              .FirstOrDefault()
   
   ' Display each instructor for the specified Course
   For Each Instructor As Instructor In instructorQuery.Person
       Me.studentList.Items.Add("Instructor: " + Instructor. _
                       LastName + ", " + Instructor.FirstName)
   Next
   

   studentList.Items.Clear();
   
   // Get the CourseID from the selected Course.
   Course course = (Course)courseList.SelectedItem;
   int courseId = course.CourseID;
   
   // Get all CourseGrade types for the supplied CourseID
   Course studentQuery = schoolContext.Course.Where(
       "it.CourseID = @courseID", new ObjectParameter
           ("courseID", courseId)).Include("CourseGrade").
           FirstOrDefault();
   
   // Get all students for each CourseGrade
   foreach (CourseGrade cg in studentQuery.CourseGrade)
   {
       cg.PersonReference.Load();
       studentList.Items.Add(cg.Person.LastName + ", " +
           cg.Person.FirstName);
   }
   
   studentList.Items.Add(" ");
   
   // Get all Instructor types for the supplied CourseID
   Course instructorQuery = schoolContext.Course.Where(
       "it.CourseID = @courseID", new ObjectParameter
           ("courseID", courseId)).Include("Person").
           FirstOrDefault();
   
   // Display each instructor for the specified course.
   foreach (Instructor instructor in instructorQuery.Person.
       OfType<Instructor>())
   {
       studentList.Items.Add("Instructor: " + instructor.
           LastName + ", " + instructor.FirstName);
   }
   

L'applicazione è ora completa. Premere Ctrl+F5 per eseguirla. Fare clic sul pulsante View Enrollment per caricare il form Enrollment. L'iscrizione al corso e i docenti per il corso selezionato sono visualizzati in ListBox.

Listato di codice

In questa sezione viene riportata la versione finale del file code-behind del form Enrollment.

Imports System.Data.Objects
Imports System.Data.Objects.DataClasses

Public Class Enrollment

    ' Create an ObjectContext instance based on SchoolEntity.
    Private schoolContext As SchoolEntities

    Private Sub Enrollment_Load(ByVal sender As System.Object, _
                ByVal e As System.EventArgs) Handles MyBase.Load
        ' Initialize the ObjectContext.
        schoolContext = New SchoolEntities()

        ' Define a query that returns all Department objects and 
        ' related Course objects, ordered by name.
        Dim departmentQuery As ObjectQuery(Of Department) = _
            schoolContext.Department.Include("Course") _
            .OrderBy("it.Name")

        ' Bind the ComboBox control to the query, which is 
        ' executed during data binding.
        Me.departmentList.DataSource = departmentQuery _
        .Execute(MergeOption.OverwriteChanges)
        Me.departmentList.DisplayMember = "Name"
    End Sub

    Private Sub departmentList_SelectedIndexChanged(ByVal sender _
            As System.Object, ByVal e As System.EventArgs) Handles _
            departmentList.SelectedIndexChanged
        ' Get the object for the selected department
        Dim department As Department = CType(Me.departmentList _
                .SelectedItem, Department)

        ' Bind the ComboBox control Course properties of
        ' the selected Department.
        courseList.DataSource = department.Course
        courseList.DisplayMember = "Title"
    End Sub

    Private Sub courseList_SelectedIndexChanged(ByVal sender As  _
            System.Object, ByVal e As System.EventArgs) Handles _
            courseList.SelectedIndexChanged
        Me.studentList.Items.Clear()

        ' Get the CourseID from the selected Course.
        Dim course As Course = CType(Me.courseList.SelectedItem,  _
             Course)
        Dim courseId As Integer = course.CourseID

        ' Get all CourseGrade objects for the supplied CourseID
        Dim studentQuery As Course = schoolContext.Course.Where _
             ("it.CourseID = @courseID", New ObjectParameter _
              ("courseID", courseId)).Include("CourseGrade"). _
              FirstOrDefault()

        ' Get all students for each CourseGrade
        For Each cg As CourseGrade In studentQuery.CourseGrade
            cg.PersonReference.Load()
            studentList.Items.Add(cg.Person.LastName + ", " + _
                                cg.Person.FirstName)
        Next

        studentList.Items.Add(" ")

        ' Get all Instructor types for the supplied CourseID
        Dim instructorQuery As Course = schoolContext.Course. _
             Where("it.CourseID = @courseID", New ObjectParameter _
                   ("courseID", courseId)).Include("Person") _
                   .FirstOrDefault()

        ' Display each instructor for the specified Course
        For Each Instructor As Instructor In instructorQuery.Person
            Me.studentList.Items.Add("Instructor: " + Instructor. _
                            LastName + ", " + Instructor.FirstName)
        Next
    End Sub
End Class

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.Data.Objects;
using System.Data.Objects.DataClasses;

namespace CourseManager
{
    public partial class Enrollment : Form
    {
        // Create an ObjectContext instance based on SchoolEntity.
        private SchoolEntities schoolContext;

        public Enrollment()
        {
            InitializeComponent();
        }

        private void Enrollment_Load(object sender, EventArgs e)
        {
            // Initialize the ObjectContext.
            schoolContext = new SchoolEntities();

            // Define a query that returns all Department objects
            // and related Course objects, ordered by name.
            ObjectQuery<Department> departmentQuery =
                schoolContext.Department.Include("Course")
                                        .OrderBy("it.Name");

            // Bind the ComboBox control to the query, which is
            // executed during data binding.
            this.departmentList.DataSource = departmentQuery
        .Execute(MergeOption.OverwriteChanges);
            this.departmentList.DisplayMember = "Name";
        }

        private void departmentList_SelectedIndexChanged(object sender, 
            EventArgs e)
        {
            // Get the object for the selected department.
            Department department =
                    (Department)this.departmentList.SelectedItem;

            // Bind the ComboBox control Course properties of 
            // the selected Department.
            courseList.DataSource = department.Course;
            courseList.DisplayMember = "Title";
        }

        private void courseList_SelectedIndexChanged(object sender, 
            EventArgs e)
        {
            studentList.Items.Clear();

            // Get the CourseID from the selected Course.
            Course course = (Course)courseList.SelectedItem;
            int courseId = course.CourseID;

            // Get all CourseGrade types for the supplied CourseID
            Course studentQuery = schoolContext.Course.Where(
                "it.CourseID = @courseID", new ObjectParameter
                    ("courseID", courseId)).Include("CourseGrade").
                    FirstOrDefault();

            // Get all students for each CourseGrade
            foreach (CourseGrade cg in studentQuery.CourseGrade)
            {
                cg.PersonReference.Load();
                studentList.Items.Add(cg.Person.LastName + ", " +
                    cg.Person.FirstName);
            }

            studentList.Items.Add(" ");

            // Get all Instructor types for the supplied CourseID
            Course instructorQuery = schoolContext.Course.Where(
                "it.CourseID = @courseID", new ObjectParameter
                    ("courseID", courseId)).Include("Person").
                    FirstOrDefault();

            // Display each instructor for the specified course.
            foreach (Instructor instructor in instructorQuery.Person.
                OfType<Instructor>())
            {
                studentList.Items.Add("Instructor: " + instructor.
                    LastName + ", " + instructor.FirstName);
            }
        } 
    }
}

Passaggi successivi

L'ereditarietà tabella per gerarchia in un modello EDM è stata dunque implementata. Per ulteriori informazioni sulla definizione di un modello EDM con ereditarietà tabella per gerarchia, vedere Procedura: definire un modello con ereditarietà tabella per gerarchia (Entity Framework). Per ulteriori informazioni sulla compilazione di applicazioni con Entity Framework, vedere Guida per programmatori (Entity Framework).

Vedere anche

Altre risorse

Scenari di ADO.NET Entity Data Model Designer
Attività degli strumenti di Entity Data Model