Condividi tramite


Aggiungere nuove origini dati nelle applicazioni ADO.NET (.NET Framework)

Nota

I set di dati e le classi correlate sono tecnologie .NET Framework legacy dei primi anni '2000 che consentono alle applicazioni di lavorare con i dati in memoria mentre le applicazioni vengono disconnesse dal database. Sono particolarmente utili per le applicazioni che consentono agli utenti di modificare i dati e rendere persistenti le modifiche apportate al database. Anche se i set di dati hanno dimostrato di essere una tecnologia molto efficace, è consigliabile che le nuove applicazioni .NET usino Entity Framework Core. Entity Framework offre un modo più naturale per usare i dati tabulari come modelli a oggetti e ha un'interfaccia di programmazione più semplice.

Nota

Le funzionalità descritte in questo articolo si applicano allo sviluppo di .NET Framework Windows Form e WPF. Le funzionalità non sono supportate per lo sviluppo di .NET Core, sia per WPF che per Windows Form.

Nel contesto di strumenti di dati .NET in Visual Studio, il termine data source fa riferimento a oggetti .NET che si connettono a un archivio dati e rendere i dati disponibili a un'applicazione .NET. Le finestre di progettazione di Visual Studio possono usare l'output dell'origine dati per generare il codice boilerplate che associa i dati a un form quando si trascinano gli oggetti di database dalla finestra Data Source. Questo tipo di origine dati può essere:

  • Classe in un modello Entity Framework associato a un tipo di database.

  • Set di dati associato a un tipo di database.

  • Classe che rappresenta un servizio di rete, ad esempio un servizio dati Windows Communication Foundation (WCF) o un servizio REST.

  • Classe che rappresenta un servizio SharePoint.

  • Classe o raccolta nella soluzione.

Nota

Se non si usano funzionalità di data binding, set di dati, Entity Framework, LINQ to SQL, WCF o SharePoint, il concetto di "origine dati" non è applicabile. È sufficiente connettersi direttamente al database usando gli oggetti SQLCommand e comunicare direttamente con il database.

È possibile creare e modificare le origini dati usando la Configurazione guidata origine dati in un'applicazione Windows Presentation Foundation o Windows Form. Per Entity Framework, creare prima le classi di entità e quindi avviare la procedura guidata selezionando Progetto>Aggiungi nuova origine dati (descritto più dettagliatamente più avanti in questo articolo).

Configurazione guidata origine dati

Finestra Origini dati

Dopo aver creato un'origine dati, viene visualizzato nei Data source finestra degli strumenti.

Suggerimento

Per aprire la finestra Data source, assicurarsi che il progetto sia aperto e quindi premere MAIUSC+Alt+1!doppure scegliere View>Other Windows>Data source.

In un progetto di Windows Form destinato a .NET Framework (non .NET Core o .NET 5 o versione successiva), è possibile trascinare un'origine dati dalla finestra Origini dati in un'area di progettazione o un controllo della maschera. Se si trascina una tabella, si ottiene un bindingNavigator e un Oggetto DataGridView per la tabella. Se si trascina una singola colonna, si ottiene un bindingNavigator e un controllo Label e un controllo TextBox per tale colonna. Trascinare le colonne per ottenere un modulo di visualizzazione dei dati completo per una tabella. Queste azioni causano la generazione del codice boilerplate che visualizza i dati dall'archivio dati.

La figura seguente mostra un set di dati che è stato eliminato in un Windows Form. Se si seleziona F5 nell'applicazione, i dati del database sottostante sono visualizzati nei controlli del modulo.

Screenshot che mostra l'operazione di trascinamento dell'origine dati.

Screenshot che mostra l'operazione di trascinamento dell'origine dati.

Origine dati per un database o un file di database

È possibile creare un set di dati o un modello di Entity Framework da usare come origine dati per un database o un file di database.

Set di dati

Per creare un set di dati come origine dati, eseguire la Configurazione guidata origine dati selezionando Progetto>Aggiungi nuova origine dati. Scegliere Il tipo di origine dati database e seguire le istruzioni per specificare una connessione di database nuova o esistente o un file di database.

Classi di entità

Per creare un modello di Entity Framework come origine dati:

  1. Eseguire la Creazione guidata Entity Data Model per creare le classi di entità. Selezionare Progetto>Aggiungi nuovo elemento>ADO.NET Entity Data Model.

    Nuovo elemento di progetto del modello Entity Framework

  2. Scegliere il metodo da cui si vuole generare il modello.

    Entity Data Model (procedura guidata)

  3. Aggiungere il modello come origine dati. Le classi generate vengono visualizzate nella Configurazione guidata origine dati quando si sceglie la categoria Oggetti .

    Configurazione guidata origine dati con classi di entità

Origine dati per un servizio

Per creare un'origine dati da un servizio, eseguire la Configurazione guidata origine dati e scegliere il tipo di origine dati del servizio . Questa azione è semplicemente un collegamento alla finestra di dialogo Aggiungi riferimento al servizio, a cui è anche possibile accedere facendo clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e selezionando Aggiungi riferimento al servizio.

Quando si crea un'origine dati da un servizio, Visual Studio aggiunge un riferimento al servizio al progetto. Visual Studio crea anche oggetti proxy che corrispondono agli oggetti restituiti dal servizio. Ad esempio, un servizio che restituisce un set di dati viene rappresentato nel progetto come set di dati; Un servizio che restituisce un tipo specifico viene rappresentato nel progetto come tipo restituito.

È possibile creare un'origine dati dai tipi di servizi seguenti:

  • WCF Data Services

  • Servizi WCF

  • Servizi Web

    Nota

    Gli elementi visualizzati nei Data source finestra dipendono i dati restituiti al servizio. Alcuni servizi potrebbero non fornire informazioni sufficienti per consentire alla Configurazione guidata origine dati di creare oggetti associabili. Ad esempio, se il servizio restituisce un set di dati non tipizzati, viene visualizzato alcun elemento nel Data source finestra una volta completata la procedura guidata. Ciò è dovuto al fatto che i set di dati non tipizzato non forniscono uno schema e pertanto la procedura guidata non dispone di informazioni sufficienti per creare l'origine dati.

Origine dati per un oggetto

È possibile creare un'origine dati da qualsiasi oggetto che espone una o più proprietà pubbliche eseguendo la Configurazione guidata origine dati e quindi selezionando il tipo di origine dati Object . Tutte le proprietà pubbliche di un oggetto vengono visualizzate nei Data source finestra. Se si usa Entity Framework e si è generato un modello, è possibile trovare le classi di entità che rappresentano le origini dati per l'applicazione.

Nella pagina Seleziona oggetti dati espandere i nodi nella visualizzazione albero per individuare gli oggetti a cui si desidera eseguire l'associazione. La visualizzazione albero contiene nodi per il progetto e per gli assembly e altri progetti a cui fa riferimento il progetto.

Per associare un oggetto in un assembly o un progetto che non viene visualizzato nella visualizzazione albero, fare clic su Aggiungi riferimento e utilizzare la finestra di dialogo Aggiungi riferimento per aggiungere un riferimento all'assembly o al progetto. Dopo aver aggiunto il riferimento, l'assembly o il progetto viene aggiunto alla visualizzazione albero.

Nota

Potrebbe essere necessario compilare il progetto che contiene gli oggetti prima che gli oggetti vengano visualizzati nella visualizzazione albero.

Nota

Per supportare il data binding di trascinamento della selezione, gli oggetti che implementano l'interfaccia ITypedList o IListSource devono avere un costruttore predefinito. In caso contrario, Visual Studio non può creare un'istanza dell'oggetto origine dati e viene visualizzato un errore quando si trascina l'elemento nell'area di progettazione.

Origine dati per un elenco di SharePoint

È possibile creare un'origine dati da un elenco di SharePoint eseguendo la Configurazione guidata origine dati e selezionando il tipo di origine dati di SharePoint . SharePoint espone i dati tramite WCF Data Services, pertanto la creazione di un'origine dati di SharePoint equivale alla creazione di un'origine dati da un servizio. Se si seleziona l'elemento di SharePoint nella Configurazione guidata origine dati, viene visualizzata la finestra di dialogo Aggiungi riferimento al servizio dati di SharePoint, in cui ci si connette al servizio dati di SharePoint puntando a SharePoint Server. Questa azione richiede SharePoint SDK.