Gewusst wie: Konfigurieren von Parametern für Datenadapter
Aktualisiert: November 2007
In den meisten Fällen verweisen die Command-Objekte (SelectCommand, InsertCommand, UpdateCommand und DeleteCommand) auf SQL-Anweisungen oder gespeicherte Prozeduren, für die Parameter erforderlich sind. Wenn Sie den Adapter mit dem Datenadapter-Konfigurations-Assistenten erstellt haben, werden die Parameter für diese Befehle automatisch konfiguriert. Sie können die Parameter jedoch auch manuell konfigurieren oder kleine Änderungen an einer bestehenden Parameterauflistung vornehmen.
.gif "Hinweis") Hinweis: |
|---|
In der vorherigen Version von Visual Studio wurden Datenadapter für die Kommunikation zwischen einer Anwendung und einer Datenbank verwendet. Während Datenadapter eine zentrale Komponente von .NET Framework-Datenanbieter (ADO.NET) darstellen, sind TableAdapters vom Designer generierte Komponenten, die das Verschieben von Daten zwischen der Anwendung und einer Datenbank vereinfachen. Weitere Informationen zum Verwenden von TableAdapter finden Sie unter Übersicht über TableAdapters. |
| Tipp: |
|---|
Um Parameter zu konfigurieren, nachdem Änderungen an der SQL-Anweisung für einen Befehl vorgenommen wurden, wählen Sie im Abfrage-Generator die Option Parameterauflistung für diesen Befehl erneut generieren aus. |
| Hinweis: |
|---|
Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Visual Studio-Einstellungen. |
So konfigurieren Sie Parameter für einen Datenadapter
Erstellen Sie einen Datenadapter. Weitere Informationen finden Sie unter Erstellen von Datenadaptern.
Wählen Sie den Datenadapter im Formular- oder Komponenten-Designer aus, und öffnen Sie dann das Eigenschaftenfenster.
Erweitern Sie das Befehlsobjekt, für das Sie die Parameter konfigurieren möchten (z. B. UpdateCommand). Klicken Sie anschließend in der Parameters-Eigenschaft auf die Schaltfläche mit den Auslassungszeichen (...), um das Fenster Parameterauflistungs-Editor zu öffnen.
Klicken Sie auf Hinzufügen, um ein neues Parameterobjekt zu erstellen.
Stellen Sie den neuen Parameter an die korrekte Indexposition in der Auflistung für diesen Parameter, indem Sie auf die Pfeile unter Sortieren klicken.
Um die Parametereigenschaften festzulegen, wählen Sie den Parameter in der Liste Members aus und verwenden anschließend das Eigenschaftenraster auf der rechten Seite. In der folgenden Tabelle sind die Eigenschaften aufgeführt, die in der Regel festgelegt werden.
Eigenschaft
Beschreibung
SourceColumn
Der Name einer Spalte in einer Dataset-Tabelle, aus der der Parameterwert gelesen wird. Diese Eigenschaft wird mit Parametern verwendet, die Werte in eine UPDATE-Anweisung, eine INSERT-Anweisung oder eine DELETE-Anweisung (oder entsprechende gespeicherte Prozeduren) einsetzen.
SourceVersion
Wenn der Parameterwert über die SourceColumn-Eigenschaft abgeleitet wird, gibt SourceVersion an, welche Version eines Dataset-Datensatzes als Quelle des Parameterwerts verwendet werden soll:
Original - Der aus der Datenbank gelesene Wert der Spalte. Verwenden Sie diese Option, wenn Sie den Spaltenwert vor der Änderung benötigen. Beispiel: Sie benötigen den Ursprungswert eines geänderten Primärschlüssels, um den entsprechenden Datensatz in der Datenbank zu suchen.
Current - Der Wert der Spalte nach Aktualisierung eines Datensatzes. Dies ist in der Regel der Wert, der in die Datenbank geschrieben wird.
Default - Der für eine Spalte festgelegte Wert, wenn kein Wert explizit angegeben wird.
Value
Ein expliziter Wert, der für den Parameter gesetzt werden soll. Diese Eigenschaft wird häufig zur Laufzeit und nicht statisch während der Entwurfszeit gesetzt.
Die Value-Eigenschaft hat Priorität vor der SourceColumn-Eigenschaft, wenn beide festgelegt wurden.
NamedParameter
Ein Boolescher Wert, der angibt, ob der Parameter der Variablen (normalerweise im Format @parametername) oder einem Platzhalter (normalerweise ein Fragezeichen) entspricht. Wenn Sie mit einem SqlConnection-Objekt arbeiten und benannte Parameter verwenden, setzen Sie diese Eigenschaft auf true.
DBType, Precision, Scale, Size
Informationen über den programmeigenen Datentyp (im Datenspeicher) des Parameterwerts. Der Parameterwert wird in den oder aus dem angegebenen Typ konvertiert.
Direction
Gibt an, ob der Parameterwert an den Befehl übergeben oder vom Befehl zurückgegeben wird:
Input - Dieser Wert wird an den Befehl übergeben. Dies ist die Standardeinstellung.
Output - Dieser Wert wird von einer gespeicherten Prozedur zurückgegeben. (Gilt nicht für SQL-Anweisungen.)
InputOutput - Dieser Wert wird an eine gespeicherte Prozedur übergeben und in der Regel mit einem geänderten Wert zurückgegeben.
ReturnValue - Dieser Wert ist ein expliziter Rückgabewert. Standardmäßig ist der zurückgegebene Wert das erste Element (Indexwert 0 (null)) in der Parameterauflistung.
ParameterName
Ein Name, über den Sie auf den Parameter in einer Auflistung verweisen können, anstatt über seinen Indexwert darauf zu verweisen. Obwohl Parameternamen nicht erforderlich sind, empfiehlt sich deren Verwendung aufgrund der komfortableren Verwaltung.
Klicken Sie auf OK, um das Fenster Parameterauflistungs-Editor zu schließen.
Wiederholen Sie die Schritte 3 bis 7, um Parameter für weitere Befehlsobjekte zu konfigurieren.