Metodi DataContext (Progettazione relazionale oggetti)

Articolo
04/19/2011

I metodi DataContext (nel contesto di Progettazione relazionale oggetti) rappresentano metodi della classe DataContext che eseguono stored procedure e funzioni in un database.

La classe DataContext rappresenta una classe LINQ to SQL che funge da canale tra un database SQL Server e le classi di entità LINQ to SQL con mapping a tale database. La classe DataContext contiene le informazioni sulla stringa di connessione e i metodi per la connessione a un database e la modifica dei dati presenti in esso. Per impostazione predefinita, la classe DataContext contiene diversi metodi che è possibile chiamare, ad esempio il metodo SubmitChanges che invia dati aggiornati dalle classi LINQ to SQL al database. È anche possibile creare metodi DataContext aggiuntivi con mapping a stored procedure e funzioni. In altre parole, la chiamata a questi metodi personalizzati determinerà l'esecuzione della stored procedure o funzione nel database a cui è stato eseguito il mapping del metodo DataContext. È possibile aggiungere nuovi metodi alla classe DataContext nello stesso modo in cui si aggiungono per estendere qualsiasi classe. Tuttavia, quando si considerano i metodi DataContext nel contesto di O/R Designer, si intendono fondamentalmente i metodi DataContext con mapping a stored procedure e funzioni.

Nota

In LINQ to SQL le stored procedure e le funzioni vengono gestite nello stesso modo, nel senso che viene eseguito il mapping di entrambe alle classi di entità utilizzando lo stesso oggetto StoredProcedureAttribute. Nel contesto di LINQ to SQL, i metodi DataContext con mapping a stored procedure sono gli stessi di quelli con mapping a funzioni.

Riquadro Metodi

I metodi DataContext con mapping a stored procedure e funzioni vengono visualizzati nel riquadro dei metodi di O/R Designer. Il riquadro dei metodi rappresenta il riquadro situato sul lato del riquadro delle entità (l'area di progettazione principale). Nel riquadro dei metodi vengono elencati tutti i metodi DataContext creati utilizzando O/R Designer. Per impostazione predefinita, il riquadro dei metodi è vuoto. Trascinare stored procedure o funzioni da Esplora server/Esplora database in O/R Designer per creare metodi DataContext e popolare il riquadro dei metodi. Per ulteriori informazioni, vedere Procedura: creare metodi DataContext con mapping a stored procedure e funzioni (Progettazione relazionale oggetti).

Nota

Per aprire e chiudere il riquadro dei metodi, fare clic con il pulsante destro del mouse su O/R Designer, quindi fare clic su Nascondi riquadro Metodi o Mostra riquadro Metodi oppure utilizzare il tasto di scelta rapida CTRL+1.

Due tipi di metodi DataContext

I metodi DataContext sono metodi con mapping a stored procedure e funzioni nel database. È possibile creare e aggiungere metodi DataContext nel riquadro dei metodi di O/R Designer. Esistono due tipi distinti di metodi DataContext: quelli che restituiscono uno o più set di risultati e quelli che non restituiscono alcun set di risultati.

Metodi DataContext che restituiscono uno o più set di risultati:

Creare questo tipo di metodo DataContext quando l'applicazione deve eseguire stored procedure e funzioni nel database e restituire i risultati. Per ulteriori informazioni, vedere Procedura: creare metodi DataContext con mapping a stored procedure e funzioni (Progettazione relazionale oggetti), [T:System.Data.Linq.ISingleResult'1] e IMultipleResults.
Metodi DataContext che non restituiscono set di risultati, ad esempio inserimenti, aggiornamenti ed eliminazioni per una classe di entità specifica.

Creare questo tipo di metodo DataContext quando l'applicazione deve eseguire stored procedure anziché utilizzare il comportamento LINQ to SQL predefinito per salvare i dati modificati tra una classe di entità e il database. Per ulteriori informazioni, vedere Procedura: assegnare stored procedure per l'esecuzione dei comandi di aggiornamento, inserimento ed eliminazione (Progettazione relazionale oggetti).

Tipi restituiti dei metodi DataContext

Quando si trascinano stored procedure e funzioni da Esplora server/Esplora database in O/R Designer, il tipo restituito del metodo DataContext generato varia a seconda della posizione in cui si rilascia l'elemento. Il rilascio degli elementi direttamente in una classe di entità esistente crea un metodo DataContext con il tipo restituito della classe di entità, mentre il rilascio degli elementi in un'area vuota di O/R Designer (in uno dei riquadri) crea un metodo DataContext che restituisce un tipo generato automaticamente. Questo tipo creato è dotato di un nome corrispondente a quello della stored procedure o funzione e di proprietà con mapping ai campi restituiti dalla stored procedure o funzione.

Nota

È possibile modificare il tipo restituito di un metodo DataContext dopo averlo aggiunto al riquadro dei metodi. Per controllare o modificare il tipo restituito di un metodo DataContext, selezionarlo e controllare la proprietà Return Type nella finestra Proprietà. Per ulteriori informazioni, vedere Procedura: modificare il tipo restituito di un metodo DataContext (Progettazione relazionale oggetti).

Gli oggetti trascinati dal database nell'area Progettazione relazionale oggetti vengono denominati automaticamente, in base al nome degli oggetti nel database. Se si trascina più volte lo stesso oggetto, i vari nomi vengono distinti grazie all'aggiunta di un numero alla fine del nuovo nome. Se i nomi degli oggetti di database contengono spazi o caratteri non supportati in Visual Basic o C#, lo spazio o il carattere non valido viene sostituito con un carattere di sottolineatura.