Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

IDataParameter-Schnittstelle

 

Veröffentlicht: Juli 2016

Stellt einen Parameter sowie optional dessen Zuordnung zu DataSet-Spalten für ein Command-Objekt dar und wird von .NET Framework-Datenanbietern implementiert, die auf Datenquellen zugreifen.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

public interface IDataParameter

NameBeschreibung
System_CAPS_pubpropertyDbType

Ruft den DbType des Parameters ab oder legt ihn fest.

System_CAPS_pubpropertyDirection

Ruft einen Wert ab, der angibt, ob der Parameter nur zur Eingabe, nur zur Ausgabe oder bidirektional verwendet wird oder ob es sich um einen Parameter für den Rückgabewert einer gespeicherten Prozedur handelt, oder legt diesen Wert fest.

System_CAPS_pubpropertyIsNullable

Ruft einen Wert ab, der anzeigt, ob der Parameter NULL-Werte akzeptiert.

System_CAPS_pubpropertyParameterName

Ruft den Namen der IDataParameter ab oder legt diesen fest.

System_CAPS_pubpropertySourceColumn

Ruft den Namen der Quellspalte ab, die dem DataSet zugeordnet ist und zum Laden oder Zurückgeben des Value verwendet wird, oder legt diesen Namen fest.

System_CAPS_pubpropertySourceVersion

Ruft die DataRowVersion ab, die beim Laden von Value verwendet werden soll, oder legt diese fest.

System_CAPS_pubpropertyValue

Ruft den Wert des Parameters ab oder legt diesen fest.

Die IDataParameter Schnittstelle ermöglicht es eine erbende Klasse zum Implementieren einer Parameterklasse, die einen Parameter für ein Command-Objekt darstellt. Weitere Informationen über Parameter-Klassen finden Sie unter Konfigurieren von Parametern und Parameterdatentypen.

Eine Anwendung erstellt eine Instanz der nicht der IDataParameter -Schnittstelle direkt, sondern erstellt eine Instanz einer Klasse, die erbt IDataParameter.

Klassen, erben IDataParameter müssen Sie die geerbten Member implementieren und definieren Sie in der Regel zusätzliche Elemente, um die anbieterspezifische Funktionalität hinzufügen. Z. B. die IDataParameter Schnittstelle definiert die DbType Eigenschaft. Wiederum die OleDbParameter Klasse erbt Sie diese Eigenschaft, und definiert auch die OleDbType Eigenschaft.

Hinweise für Implementierer:

Zur Förderung der Konsistenz zwischen .NET Framework-Datenanbieter, benennen Sie die erbende Klasse in der Form Prv Parameter, in denen Prv ist die einheitliche Präfix für alle Klassen in einem bestimmten .NET Framework Data Provider-Namespace. Beispielsweise Sql ist das Präfix des der SqlCommand -Klasse in der System.Data.SqlClient Namespace.

Beim Erben von der IDataParameter -Schnittstelle, implementieren Sie die folgenden Konstruktoren:

Element

Beschreibung

PrvParameter()

Initialisiert eine neue Instanz der Parameter-Klasse.

PrvParameter (Zeichenfolgennamen, PrvDbType-Datentyp)

Initialisiert eine neue Instanz der Klasse Parameter mit dem Namen und den Parametertyp an.

PrvParameter (Zeichenfolgennamen, Objektwert)

Initialisiert eine neue Instanz der Parameter-Klasse mit dem Parameternamen und ein Objekt, das der Wert des Parameters ist.

PrvParameter (Zeichenfolgennamen, PrvDbType Datentyp Int-Größe)

Initialisiert eine neue Instanz der Klasse Parameter mit den Parameternamen, den Datentyp und die Breite an.

PrvParameter (Zeichenfolgennamen, PrvDbType DataType, Int-Größe, SrcColumn Zeichenfolge)

Initialisiert eine neue Instanz der DbParameter-Klasse mit dem Parameternamen, Datentyp, Breite und Quellspaltennamen an.

PrvParameter (Zeichenfolge ParameterName, PrvDbType DbType, Int-Größe, "ParameterDirection" Richtung, boolesche IsNullable, Byte Genauigkeit, Byte-Umfang, Zeichenfolge SrcColumn, "DataRowVersion" SrcVersion, Objektwert)

Initialisiert eine neue Instanz der dem OleDbParameter -Klasse mit den Namen des Parameters, Datentyp, Breite, Quellspaltenname, parameterrichtung, numerische Genauigkeit und andere Eigenschaften.

Das folgende Beispiel erstellt mehrere Instanzen der abgeleiteten Klasse SqlParameter, bis die SqlParameterCollection Auflistung innerhalb der SqlDataAdapter. Diese Parameter dienen zum Auswählen von Daten aus der Datenquelle und das Einfügen von Daten in der DataSet. In diesem Beispiel wird vorausgesetzt, dass ein DataSet und ein SqlDataAdapter mit dem entsprechenden Schema, die Befehle und die Verbindung bereits erstellt wurden.

public void AddSqlParameters() 
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);

}

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: