Panoramica sui file con estensione edmx (Entity Framework)

Un file con estensione edmx è un file XML che definisce un modello concettuale, un modello di archiviazione e il mapping tra questi modelli. Un file con estensione edmx contiene inoltre le informazioni utilizzate da ADO.NET Entity Data Model Designer (Entity Designer) per eseguire il rendering grafico di un modello. Per creare un file con estensione edmx, si consiglia di utilizzare la procedura guidata Entity Data Model. Per ulteriori informazioni, vedere Procedura: creare un nuovo file con estensione edmx (strumenti di Entity Data Model).

Un file con estensione edmx viene modificato quanto si utilizza Entity Designer per modificare il modello e quando si utilizza la procedura guidata Aggiorna Modello per aggiornare il modello in base alle modifiche apportate al database sottostante. Per ulteriori informazioni, vedere Procedura guidata Aggiorna modello (strumenti di Entity Data Model). In alcuni scenari, inoltre, potrebbe essere necessario modificare manualmente un file con estensione edmx. Per ulteriori informazioni, vedere Modifica manuale di un file con estensione edmx (Entity Framework).

Per impostazione predefinita, un file con estensione edmx viene aperto con Entity Designer. Tuttavia, un file di questo tipo può essere aperto anche con l'editor XML seguendo questa procedura:

1. Verificare che il progetto sia aperto in Visual Studio.

2. Fare clic con il pulsante destro del mouse sul file con estensione edmx in Esplora soluzioni e selezionare Apri con....

3. Selezionare Editor XML e fare clic su OK.

Contenuto del file con estensione edmx

Di seguito è riportata un'analisi di alto livello del contenuto di un file con estensione edmx. Per informazioni più dettagliate, vedere gli schemi EDMX nella directory XML di Visual Studio.

Nota:
Lo schema per le applicazioni destinate a .NET Framework versione 4 è definito nel file Microsoft.Data.Entity.Design.Edmx_2.xsd.Lo schema per le applicazioni destinate a .NET Framework versione 3.5 SP1 è definito nel file Microsoft.Data.Entity.Design.Edmx_1.xsd.

Contenuto di runtime (edmx:Runtime)

Questa sezione contiene le informazioni utilizzate per generare file di modello e di mapping per le applicazioni Entity Framework. Per ulteriori informazioni, vedere la proprietà Build Action nella sezione Proprietà dei file con estensione edmx, più avanti in questo argomento.

Nota:
Un file con estensione edmx viene aggiunto automaticamente a un'applicazione che fa riferimento a un servizio di ADO.NET Data Services.In questo caso, il file con estensione edmx contiene un nodo edmx:DataServices e non un nodo edmx:Runtime.Per ulteriori informazioni, vedere ADO.NET Data Services Framework.

• Contenuto del modello di archiviazione (edmx:StorageModels): questa sezione descrive lo schema di database di destinazione ed è scritta in SSDL (Store Schema Definition Language). Per ulteriori informazioni, vedere SSDL Specification e EntityContainer Element (SSDL).

• Contenuto del modello concettuale (edmx:ConceptualModels): questa sezione definisce i tipi di entità, i tipi complessi, le associazioni, i contenitori di entità, i set di entità e i set di associazioni del dominio applicazione. La sezione è scritta in CSDL (Conceptual Schema Definition Language). Per ulteriori informazioni, vedere CSDL Specification e EntityContainer Element (CSDL).

• Contenuto di mapping (edmx:Mappings): questa sezione descrive il mapping tra il modello concettuale e il database di destinazione ed è scritta in MSL (Mapping Specification Language). Per ulteriori informazioni, vedere MSL Specification.

Contenuto della finestra di progettazione (edmx:Designer)

Questa sezione contiene le informazioni utilizzate da Entity Designer per eseguire il rendering grafico di un modello concettuale e definire alcune proprietà del modello concettuale e della fase di progettazione.

Nota:
Un file con estensione edmx viene aggiunto automaticamente a un'applicazione che fa riferimento a un servizio di ADO.NET Data Services.In questo caso, il file con estensione edmx non contiene un nodo edmx:Designer e non è visualizzabile tramite Entity Designer.Per ulteriori informazioni, vedere ADO.NET Data Services Framework.

• Contenuto di connessione (edmx:Connection): in questa sezione vengono descritte le proprietà del modello concettuale che influiscono sulla stringa di connessione. Attualmente, l'unica proprietà che è possibile impostare in questa sezione è la proprietà MetadataArtifactProcessing. Per ulteriori informazioni, vedere Connection Strings.

• Contenuto delle opzioni (edmx:Options): in questa sezione vengono descritte le proprietà facoltative del modello concettuale. L'unica proprietà attualmente impostata è ValidateOnBuild.

• Diagrammi (edmx:Diagrams): questa sezione contiene le informazioni utilizzate da Entity Designer per eseguire il rendering di una visualizzazione grafica del modello concettuale.

Proprietà del modello concettuale

Le proprietà di un modello concettuale sono definite in un file con estensione edmx. Nell'elenco seguente vengono descritte le proprietà del modello concettuale visibili nella finestra Proprietà di Visual Studio.

Nota:
Le proprietà del modello concettuale non equivalgono alle proprietà del file con estensione edmx.Per ulteriori informazioni, vedere la sezione .edmx File Properties riportata di seguito.

• Code Generation Strategy
  Attiva o disattiva la generazione di codice del livello oggetti predefinita per il modello selezionato. Il valore Nessuna disattiva la generazione di codice predefinita. Il valore Predefinita attiva la generazione di codice predefinita. Quando si aggiunge un modello di testo personalizzato per generare codice del livello oggetti, il valore viene impostato su Nessuna. Per ulteriori informazioni, vedere Panoramica sul codice generato (Entity Data Model Designer) e Procedura: personalizzare la generazione di codice del livello oggetti (Entity Data Model Designer).

• Connection String
  Stringa di connessione del client dell'entità. La stringa di connessione visualizzata è tratta dal file App.config o Web.Config del progetto e ha lo stesso nome del Contenitore di entità. Per ulteriori informazioni, vedere Connection Strings.

• Database Generation Workflow
  Flusso di lavoro eseguito quando viene selezionato Genera database da modello. Per ulteriori informazioni, vedere Procedura: generare un database da un modello concettuale (strumenti di Entity Data Model) e Procedura: personalizzare la generazione di database (procedura guidata Crea database).

• Database Schema Name
  Nome di schema del database generato durante la creazione di un database da un modello concettuale.

• DDL Generation Template
  Modello di testo utilizzato per generare uno script del database come parte del Flusso di lavoro di generazione del database. Per ulteriori informazioni, vedere Procedura: generare un database da un modello concettuale (strumenti di Entity Data Model) e Procedura: personalizzare la generazione di database (procedura guidata Crea database).

• Entity Container Access
  Controlla se la classe del contesto dell'oggetto generata è Pubblica o Interna.

• Entity Container Name
  Nome del contenitore di entità del modello concettuale. Per ulteriori informazioni, vedere EntityContainer Element (CSDL).

• Lazy Loading Enabled
  Controlla se la proprietà LazyLoadingEnabled della classe del contesto dell'oggetto generata è true o false. Per ulteriori informazioni, vedere Panoramica sul codice generato (Entity Data Model Designer).

• Metadata Artifact Processing
  Controlla se i file di modello e di mapping (file con estensione csdl, ssdl e msl) sono incorporati in un assembly di output o vengono copiati nella directory di output.

• Namespace
  Spazio dei nomi del modello concettuale. Per ulteriori informazioni, vedere Schema Element (CSDL).

• Pluralize New Objects
  Controlla se i nuovi nomi dei set di entità e delle proprietà di navigazione vengono pluralizzati.

• Transform Related Text Templates On Save
  I modelli di testo vengono correlati a un file con estensione edmx inserendo il nome del file nel modello di testo. Per ulteriori informazioni, vedere Procedura: personalizzare la generazione di codice del livello oggetti (Entity Data Model Designer). Se la proprietà Transform Related Text Templates On Save viene impostata su True, tutti i modelli di testo correlati al file con estensione edmx vengono elaborati quando il file viene salvato. Se la proprietà è impostata su False, i modelli di testo correlati non vengono elaborati.

• Validate On Build
  Controlla se il modello viene convalidato in fase di compilazione del progetto.

Proprietà dei file con estensione edmx

Le proprietà Build Action, Custom Tool e Custom Tool Namespace sono proprietà di un file con estensione edmx. Per ulteriori informazioni sulle proprietà Copy to Output Directory e File Name di un file con estensione edmx, vedere Proprietà dei file nella documentazione di Visual Studio (la pagina potrebbe essere in inglese).

Nota:
La proprietà Copy to Output Directory del file non viene utilizzata per specificare che i file di modello e di mapping devono essere copiati nella directory di output.Utilizzare invece la proprietà Metadata Artifact Processing del modello concettuale.

Per visualizzare e modificare le proprietà di un file con estensione edmx in Visual Studio, attenersi alla seguente procedura:

1. Aprire un progetto che contiene un file con estensione edmx in Visual Studio.

2. Fare clic con il pulsante destro del mouse sul file con estensione edmx in Esplora soluzioni e selezionare Proprietà.

   Le proprietà del file verranno visualizzate nella finestra Proprietà.

Nell'elenco seguente vengono descritte le proprietà Build Action, Custom Tool e Custom Tool Namespace di un file con estensione edmx:

• Build Action
  Se la proprietà è impostata su EntityDeploy (valore predefinito), quando si esegue una compilazione vengono creati tre file dal file con estensione edmx: il file del modello concettuale (con estensione csdl), il file del modello di archiviazione (con estensione ssdl) e il file di mapping (con estensione msl). Questi file vengono incorporati come risorse o copiati nella directory di output, a seconda del valore della proprietà Metadata Artifact Processing del modello. Per ulteriori informazioni, vedere Procedura: modificare le proprietà del modello concettuale (strumenti di Entity Data Model). Per informazioni sugli altri valori della proprietà Build Action, vedere Proprietà di file (la pagina potrebbe essere in inglese).

• Custom Tool
  Se la proprietà è impostata su EntityModelCodeGenerator (valore predefinito) e Strategia di generazione del codice è impostato su Predefinita, viene creato un file di codice sorgente contenente le classi generate dal modello concettuale definito nel file con estensione edmx. Per ulteriori informazioni, vedere Panoramica sul codice generato (Entity Data Model Designer).

• Custom Tool Namespace
  Per impostazione predefinita, questa proprietà è vuota. Se si fornisce un valore, questo verrà utilizzato come spazio dei nomi per il codice generato dallo strumento specificato nella proprietà Custom Tool. Per ulteriori informazioni, vedere Panoramica sul codice generato (Entity Data Model Designer).

Vedere anche

Concetti

Panoramica sul codice generato (Entity Data Model Designer)

Altre risorse

CSDL Specification