Metodi DataContext (O/R Designer)
DataContext I metodi (nel contesto di LINQ to SQL Tools in Visual Studio) sono metodi della DataContext classe che eseguono stored procedure e funzioni in un database.
La DataContext classe è una classe LINQ to SQL che funge da canale tra un database di SQL Server e le classi di entità LINQ to SQL mappate 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 DataContext classe contiene diversi metodi che è possibile chiamare, ad esempio il SubmitChanges metodo che invia dati aggiornati dalle classi LINQ a SQL al database. È anche possibile creare metodi DataContext aggiuntivi mappati a stored procedure e funzioni. In altre parole, la chiamata di questi metodi personalizzati esegue la stored procedure o la funzione nel database a cui viene eseguito il mapping del DataContext metodo. È possibile aggiungere nuovi metodi alla classe DataContext nello stesso modo in cui si aggiungono per estendere qualsiasi classe. Tuttavia, nelle discussioni sui DataContext metodi nel contesto di Progettazione O/R, si tratta dei metodi che eseguono il DataContext mapping a stored procedure e funzioni discusse.
Riquadro Metodi
DataContext i metodi mappati a stored procedure e funzioni vengono visualizzati nel riquadro Metodi di Progettazione O/R. Il riquadro Metodi rappresenta il riquadro situato a lato del riquadro Entità (l'area di progettazione principale). Nel riquadro Metodi sono elencati tutti i DataContext metodi creati tramite Progettazione O/R. Per impostazione predefinita, il riquadro Metodi è vuoto. Trascinare stored procedure o funzioni da Esplora server o Esplora database in Progettazione O/R per creare DataContext metodi e popolare il riquadro Metodi. Per altre informazioni, vedere Procedura: Creare metodi DataContext mappati a stored procedure e funzioni (O/R Designer).
Nota
Aprire e chiudere il riquadro dei metodi facendo clic con il pulsante destro del mouse su Progettazione O/R, quindi scegliere Nascondi riquadro metodi o Mostra riquadro metodi oppure usare i tasti 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 Metodi di Progettazione O/R. 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 altre informazioni, vedere Procedura: Creare metodi DataContext mappati a stored procedure e funzioni (O/R Designer), System.Data.Linq.ISingleResult<T> 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 DataContext metodo quando l'applicazione deve eseguire stored procedure anziché usare il comportamento predefinito di LINQ to SQL per salvare i dati modificati tra una classe di entità e il database. Per altre informazioni, vedere Procedura: Assegnare stored procedure per eseguire aggiornamenti, inserimenti ed eliminazioni (O/R Designer).
Tipi restituiti dei metodi DataContext
Quando si trascinano stored procedure e funzioni da Esplora server o Esplora database in Progettazione O/R, il tipo restituito del metodo generato DataContext varia a seconda della posizione in cui si rilascia l'elemento. L'eliminazione degli elementi direttamente in una classe di entità esistente crea un DataContext metodo con il tipo restituito della classe di entità. L'eliminazione di elementi in un'area vuota di Progettazione O/R (in entrambi i riquadri) crea un metodo che restituisce un DataContext tipo generato automaticamente. Il tipo generato automaticamente ha il nome che corrisponde alla stored procedure o alle proprietà e al nome della funzione, che eseguono il mapping ai campi restituiti dalla stored procedure o dalla 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 altre informazioni, vedere Procedura: Modificare il tipo restituito di un metodo DataContext (Progettazione O/R).
Gli oggetti trascinati dal database nell'area di progettazione O/R vengono denominati automaticamente in base al nome degli oggetti nel database. Se si trascina più volte lo stesso oggetto, alla fine del nuovo nome viene aggiunto un numero che differenzia i nomi. 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.
Contenuto correlato
- Strumenti LINQ to SQL in Visual Studio
- LINQ to SQL
- Stored procedure
- Procedura: Creare metodi DataContext di cui viene eseguito il mapping a stored procedure e funzioni (O/R Designer)
- Procedura: Assegnare stored procedure per eseguire aggiornamenti, inserimenti ed eliminazioni (O/R Designer)
- Procedura dettagliata: personalizzazione del comportamento di inserimento, aggiornamento ed eliminazione delle classi di entità
- Procedura dettagliata: Creazione di classi LINQ to SQL (Object Relational Designer)