Editor für die Parameters-Auflistung

Aktualisiert: November 2007

Ermöglicht das Erstellen und konfigurieren von Parametern (die Objekte OleDbParameter, SqlParameter, OdbcParameter und OracleParameter), die mit einer SQL-Anweisung oder einer gespeicherten Prozedur in TableAdapters und Datenadaptern verknüpft sind.

Bearbeiten der Parameters-Auflistung

Der Editor für die Parameters-Auflistung wird angezeigt, wenn Sie einen TableAdapter im DataSet-Designer oder einen DataAdapter auf einem Formular oder einer Komponente im Eigenschaftenfenster konfigurieren.

Wählen Sie auf der Oberfläche des Dataset-Designer einen TableAdapter aus, und öffnen Sie den Parameterauflistungs-Editor, indem Sie im Eigenschaftenfenster die Parameters-Eigenschaft auswählen.

1. Öffnen Sie den Knoten für die Eigenschaften SelectCommand, UpdateCommand, InsertCommand und DeleteCommand.

2. Bearbeiten Sie die Parameters-Eigenschaft, um den Parameterauflistungs-Editor zu öffnen.

Hinweis:
Wenn Sie Adapter mit Designtools konfigurieren, z. B. mit dem TableAdapter-Konfigurations-Assistent oder dem Datenadapter-Konfigurations-Assistenten, werden die Parameter für den Adapter automatisch konfiguriert.

Parameternamen

Die Anweisungen oder gespeicherten Prozeduren in diesen Befehlen können mit Parameterplatzhaltern definiert werden.

Wenn Sie ein OleDbDataAdapter-Objekt verwenden, enthält die Anweisung ein Fragezeichen als Platzhalter und sieht etwa wie folgt aus:

Select * From Customers Where City = ?

Wenn Sie ein SqlDataAdapter-Objekt verwenden, kann eine Anweisung mit benannten Parametern etwa wie folgt lauten:

Select * From Customers Where City = @City

Wenn Sie ein OracleDataAdapter-Objekt verwenden, kann eine Anweisung mit benannten Oracle-Parametern etwa wie folgt lauten:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID

Hinweis:

Wenn Sie für Oracle in einer SQL-Anweisung oder gespeicherten Prozedur benannte Parameter verwenden, müssen Sie vor dem Parameternamen einen Doppelpunkt (:) einfügen. Wenn Sie allerdings auf einen benannten Parameter an einer anderen Stelle im Code verweisen (z. B. beim Aufrufen der Add-Methode), fügen Sie vor dem benannten Parameter keinen Doppelpunkt (:) ein. Der Datenprovider stellt den Doppelpunkt automatisch bereit.

Hinzufügen von Parametern

Die Parameters-Auflistung für einen Befehl (z. B. Parameters) enthält eine Liste von Parameterobjekten, die zur Laufzeit, zum Übergeben von Werten an die Anweisungen oder gespeicherte Prozeduren verwendet werden. Daher ist für jeden Parameterwert, der an einen Befehl übergeben werden muss, ein Parameterobjekt vorhanden.

Der Editor ist in zwei Bereiche unterteilt. Im linken Bereich können Sie Parameter hinzufügen und löschen, im rechten Bereich legen Sie u. a. folgende Eigenschaften für einen einzelnen Parameter fest:

• Die ParameterName-Eigenschaft, anhand der Sie im Code auf den Parameter verweisen können.

  Hinweis:
  Die SqlDataAdapter-Klasse erfordert benannte Parameter, daher muss dem Namen in SqlParameter-Objekten stets "@" vorangestellt werden.

• Die SourceColumn-Eigenschaft, die angibt, von welcher Stelle in einem Datensatz der Wert des Parameters stammt. Dieser Wert wird bei Aktualisierungen verwendet. Der Datenadapter übergibt den Wert einer bestimmten Spalte an den Aktualisierungsbefehl.

• Die SourceVersion-Eigenschaft, die in Verbindung mit der SourceColumn-Eigenschaft verwendet wird. Wenn ein Datensatz im Dataset sich geändert hat, sind mehrere Kopien des Datensatzes verfügbar, z. B. der ursprüngliche Wert (wie aus der Datenquelle eingelesen) und der aktuelle Wert (nach den Änderungen). Wenn Sie einen als Parameter zu übergebenden Spaltenwert angeben, wählen Sie aus, welcher der beiden Werte übergeben werden soll. In der Regel wird der ursprüngliche Wert als Parameter in einer WHERE-Klausel verwendet, um den Datensatz in der Datenbank anzugeben, und der aktuelle Wert wird in der SET- oder VALUES-Klausel verwendet.

• Die Value-Eigenschaft, die ein expliziter Literalwert ist, der als Parameter übergeben werden soll. Durch Festlegen dieser Eigenschaft wird die SourceColumn-Eigenschaft überschrieben. Diese beiden Eigenschaften schließen einander aus.

Weitere Informationen zu Parametern finden Sie unter Parameter in Datenadapterbefehlen.

Elementliste der Benutzeroberfläche

• Add
  Hiermit erstellen Sie einen neuen Parameter in der Auflistung. Die Tabelle hat den Standardnamen Parametern, wobei n eine fortlaufende Nummer ist. Sie können die Tabelle umbenennen, indem Sie ihre ParameterName-Eigenschaft im Eigenschaftenraster ändern.

  Hinweis:
  Der Editor für die Parameters-Auflistung überprüft nicht, ob Sie für den Befehl die richtige Anzahl von Parametern erstellen oder ob diese den richtigen Typ aufweisen.

  Parameter werden nach ihrer Position Parameterplatzhaltern in den Anweisungen oder Befehlen zugeordnet. Achten Sie deshalb darauf, dass die Parameter in der richtigen Reihenfolge in der Auflistung enthalten sind.

• Remove
  Hiermit löschen Sie den ausgewählten Parameter aus der Auflistung.

Siehe auch

Konzepte

Übersicht über das Anzeigen von Daten

Referenz

SqlParameter

Weitere Ressourcen

TableAdapters

Herstellen von Datenverbindungen in Visual Studio

Vorbereiten der Anwendung auf den Empfang von Daten

Abrufen von Daten für die Anwendung

Anzeigen von Daten in Formularen in Windows-Anwendungen

Bearbeiten von Daten in der Anwendung

Überprüfen von Daten

Speichern von Daten