Procedura: implementare l'aggiornamento gerarchico in progetti di Visual Studio esistenti
A partire da Visual Studio 2008, i dataset tipizzati sono migliorati grazie all'introduzione del componente TableAdapterManager. TableAdapterManager consente di ridurre il codice necessario per salvare i dati in più tabelle correlate da diverse routine contenenti molte righe di codice a una sola chiamata al metodo TableAdapterManager.UpdateAll(TypedDataset). Per impostazione predefinita, l'aggiornamento gerarchico viene abilitato per tutti i nuovi dataset aggiunti o creati in un progetto. I dataset esistenti (ovvero quelli creati in versioni di Visual Studio precedenti a Visual Studio 2008) non includono un componente TableAdapterManager. Pertanto, per impostazione predefinita, per i dataset creati nelle versioni precedenti la proprietà Aggiornamento gerarchico è impostata su False. Generare i componenti TableAdapterManager impostando la proprietà Aggiornamento gerarchico su True e salvando il dataset. Per ulteriori informazioni, vedere Panoramica di TableAdapterManager.
Abilitazione dell'aggiornamento gerarchico e generazione del componente TableAdapterManager
Nota
Nomi o percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni vedere Customizing Development Settings in Visual Studio.
Per abilitare l'aggiornamento gerarchico nelle versioni precedenti di dataset tipizzati
Aprire il progetto che contiene uno o più dataset tipizzati in Visual Studio.
Completare la Conversione guidata di Visual Studio.
Aprire il dataset in Creazione e modifica di dataset tipizzati facendo doppio clic sul file con estensione xsd in Esplora soluzioni.
Fare clic su un'area vuota di Progettazione DataSet.
Trovare la proprietà Aggiornamento gerarchico nella finestra Proprietà.
Impostare il valore della proprietà Aggiornamento gerarchico su True.
Scegliere Compila soluzione dal menu Compila.
Configurazione di TableAdapterManager e salvataggio dei dati
L'impostazione della proprietà Aggiornamento gerarchico su True e il salvataggio del dataset generano il componente TableAdapterManager che consente l'aggiornamento gerarchico. Dopo avere generato il componente TableAdapterManager, aggiornare il codice esistente per creare un'istanza di un nuovo TableAdapterManager e chiamare il metodo TableAdapterManager.UpdateAll() anziché chiamare i singoli metodi TableAdapter.Update(). Se il codice TableAdapter esistente si trova in una libreria di classi (o in qualsiasi file privo di interfaccia utente), è necessario creare un'istanza a livello di codice di un nuovo TableAdapterManager. Se il codice TableAdapter esistente si trova in un form, è possibile creare un'istanza di un nuovo TableAdapterManager trascinando un componente TableAdapterManager dalla Casella degli strumenti al form.
I TableAdapterManager sono fortemente tipizzati, ossia sono generati con proprietà che fanno riferimento ai singoli TableAdapter che gestiscono. Dopo avere creato un'istanza di un TableAdapterManager, impostare le singole proprietà TableAdapter sulle istanze di ciascun TableAdapter, come illustrato nelle procedure descritte di seguito.
Per aggiungere un TableAdapterManager a un progetto esistente privo di interfaccia utente
Trovare il codice che chiama i metodi TableAdapter.Update (ad esempio, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).
Sostituire il codice che chiama i singoli metodi TableAdapter.Update con gli elementi seguenti:
Dim adapterManager as new TableAdapterManager adapterManager.TableName1TableAdapter = new _ TableName1TableAdapter adapterManager.TableName2TableAdapter = new _ TableName2TableAdapter adapterManager.UpdateAll(Me.DataSetName)TableAdapterManager adapterManager = new TableAdapterManager(); adapterManager.TableName1TableAdapter = new TableName1TableAdapter(); adapterManager.TableName2TableAdapter = new TableName2TableAdapter(); adapterManager.UpdateAll(this.DataSetName);
Per aggiungere un TableAdapterManager a un progetto esistente dotato di interfaccia utente
Aprire il form nella visualizzazione Progettazione.
Trascinare un componente TableAdapterManager dalla Casella degli strumenti al form.
Trovare il codice che chiama i metodi TableAdapter.Update (ad esempio, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).
Sostituire il codice che chiama i singoli metodi TableAdapter.Update con gli elementi seguenti:
Me.TableAdapterManager.TableName1TableAdapter = _ new DatasetNameTableAdapters.TableName1TableAdapter Me.TableAdapterManager.TableName2TableAdapter = _ new DatasetNameTableAdapters.TableName2TableAdapter Me.TableAdapterManager.UpdateAll(Me.DataSetName)TableAdapterManager.TableName1TableAdapter = new TableName1TableAdapter(); TableAdapterManager.TableName2TableAdapter = new TableName2TableAdapter(); TableAdapterManager.UpdateAll(this.DataSetName);