Gewusst wie: Hinzufügen von Code zu TableAdapters in N-Tier-Anwendungen

  • Artikel

Sie können die Funktionen eines TableAdapter erweitern, indem Sie eine partielle Klassendatei für den TableAdapter erstellen und Code hinzufügen (anstatt Code zur DatasetNameDataSet.Designer-Datei hinzuzufügen). (Mit partiellen Klassen können Sie Code für eine bestimmte Klasse auf mehrere physische Dateien aufteilen. Weitere Informationen finden Sie unter Partial (Visual Basic) bzw. partial (Typ) (C#-Referenz).)

Der Code, der TableAdapter definiert, wird jedes Mal generiert, wenn Änderungen am TableAdapter vorgenommen werden (im DataSet-Designer). Dieser Code wird auch generiert, wenn Sie einen Assistenten verwenden, der die Konfigurationen von TableAdapter ändert. Um zu vermeiden, dass Code beim erneuten Generieren eines TableAdapter gelöscht wird, fügen Sie Code der Datei für die partielle Klasse von TableAdapter hinzu.

Standardmäßig wird bei einer Trennung von DataSet-Code und TableAdapter-Code eine separate Klassendatei in jedem Projekt angelegt. Das ursprüngliche Projekt enthält eine Datei mit dem Namen DatasetName.Designer.vb (oder DatasetName.Designer.cs), die den TableAdapter-Code enthält. Das Projekt, das in der DataSet-Projekt-Eigenschaft ausgewählt wurde, verfügt über eine Datei mit dem Namen DatasetName.DataSet.Designer.vb (oder DatasetName.DataSet.Designer.cs), die den DataSet-Code enthält.

Tipp

Wenn Sie DataSets und TableAdapter durch Festlegen der DataSet-Projekt-Eigenschaft trennen, werden vorhandene partielle DataSet-Klassen im Projekt nicht automatisch verschoben. Vorhandene partielle Dataset-Klassen müssen manuell ins Dataset-Projekt verschoben werden.

Tipp

Der DataSet-Designer unterstützt außerdem Funktionen zum Generieren der Eventhandler ColumnChanging und RowChanging, wenn Validierungscode hinzugefügt werden soll. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Validierungen zu einem N-Tier-DataSet.

Tipp

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

So fügen Sie einem TableAdapter in einer N-Tier-Anwendung Benutzercode hinzu

  1. Suchen Sie das Projekt, das die XSD-Datei (DataSet-Designer) enthält.

  2. Doppelklicken Sie auf die Datei .xsd, um den DataSet-Designer zu öffnen.

  3. Klicken Sie mit der rechten Maustaste auf den TableAdapter, dem Sie Code hinzufügen möchten, und klicken Sie auf Code anzeigen.

    Eine partielle Klasse wird erstellt und im Code-Editor geöffnet.

  4. Fügen Sie Code innerhalb der Deklaration der partiellen Klasse hinzu.

  5. Im Folgenden wird verdeutlicht, an welcher Stelle Code im NorthwindDataSet dem CustomersTableAdapter hinzugefügt wird:

    Partial Public Class CustomersTableAdapter
    ' Add code here to add functionality 
    ' to the CustomersTableAdapter.
End Class

    public partial class CustomersTableAdapter
{
    // Add code here to add functionality
    // to the CustomersTableAdapter.
}

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von Code zu DataSets in N-Tier-Anwendungen

Konzepte

Übersicht über N-Tier-Datenanwendungen

Übersicht über TableAdapterManager

Übersicht über die hierarchische Aktualisierung

Weitere Ressourcen

TableAdapters

Erstellen von Datenanwendungen