Metodi DataContext (O/R Designer)

  • Articolo
  • 4 minuti per la lettura

Si applica a:yes Visual Studio Visual Studio noper Mac noVisual Studio Code

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 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 da LINQ a classi 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 DataContext metodi che vengono mappati a stored procedure e funzioni che vengono discusse.

Riquadro Metodi

DataContext i metodi che vengono 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). Il riquadro Metodi elenca 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 e quindi scegliere Nascondi riquadro metodi o Mostra riquadro metodi oppure usare 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 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:

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 DataContext del metodo generato varia a seconda della posizione in cui si rilascia l'elemento. L'eliminazione degli elementi direttamente in una classe di entità esistente crea un metodo con il tipo restituito della classe di entità. L'eliminazione degli elementi in un'area vuota di Progettazione O/R (in entrambi i riquadri) crea un DataContext metodo che restituisce un DataContext tipo generato automaticamente. Il tipo generato automaticamente ha il nome corrispondente alla stored procedure o alle proprietà e al nome della funzione, che vengono mappati 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 (O/R Designer).

Gli oggetti trascinati dal database nell'area progettazione O/R vengono denominati automaticamente, in base al nome degli oggetti nel database. Se si trascina più volte lo stesso oggetto, viene aggiunto un numero alla fine del nuovo nome 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.

Vedi anche