Condividi tramite

Procedura: estendere la funzionalità di un TableAdapter

  • Articolo

 

Data di pubblicazione: aprile 2016

È possibile estendere la funzionalità di un TableAdapter aggiungendo il codice al file di classe parziale del TableAdapter.

Il codice che definisce un TableAdapter viene rigenerato quando si effettuano modifiche al TableAdapter (nella finestra di progettazione Progettazione DataSet) oppure quando si effettuano modifiche alla configurazione di un TableAdapter in fase di esecuzione di una procedura guidata. Per evitare l'eliminazione del codice durante la rigenerazione di un TableAdapter, aggiungere codice al file di classe parziale del TableAdapter.

Mediante le classi parziali è possibile suddividere il codice di una classe specifica tra più file fisici. Per ulteriori informazioni, vedere Partial o parziale (Tipo).

Individuazione dei TableAdapter nel codice.

Sebbene i TableAdapter vengano progettati con Progettazione DataSet, le classi TableAdapter generate non vengono create come classi annidate di DataSet I TableAdapter sono posizionati in uno spazio dei nomi in base al nome del dataset associato al TableAdapter. Ad esempio, se nell'applicazione in uso è contenuto un dataset denominato HRDataSet, i TableAdapters sono posizionati nello spazio dei nomi HRDataSetTableAdapters. Nella convenzione di denominazione si segue il modello riportato di seguito: NomeDataset + TableAdapters.

Nell'esempio riportato di seguito si presuppone un TableAdapter denominato CustomersTableAdapter in un progetto con un dataset NorthwindDataSet.

Per creare una classe parziale per un TableAdapter

  1. Aggiungere una nuova classe al progetto scegliendo Aggiungi classe dal menu Progetto.

  2. Denominare la classe CustomersTableAdapterExtended.

  3. Scegliere Aggiungi.

  4. Sostituire il codice con lo spazio dei nomi e il nome della classe parziale appropriati al progetto in uso. Di seguito è riportato un esempio:

    namespace NorthwindDataSetTableAdapters
{
    public partial class CustomersTableAdapter
    {
        // Add user code here. For example:
        public override string ToString()
        {
            return "Overridden in the partial class.";
        }
    }
}

    Namespace NorthwindDataSetTableAdapters

    Partial Class CustomersTableAdapter

        ' Add user code here. For example:
        Public Overrides Function ToString() As String
            Return "Overridden in the partial class."
        End Function
    End Class
End Namespace

Vedere anche

Cenni preliminari sugli oggetti TableAdapter
Procedura: creare oggetti TableAdapter
Procedura: creare query TableAdapter
Procedura: estendere la funzionalità di un dataset
Procedure dettagliate relative ai dati
Associazione di controlli Windows Form ai dati in Visual Studio
Cenni preliminari sulle applicazioni dati in Visual Studio
Connessione ai dati in Visual Studio
Preparazione dell'applicazione al ricevimento di dati
Recupero di dati nell'applicazione
Associazione di controlli ai dati in Visual Studio
Modifica di dati nell'applicazione
Convalida dei dati
Salvataggio di dati