IDataParameterCollection-Schnittstelle
Listet alle für ein Command-Objekt relevanten Parameter sowie ihre Zuordnungen zu DataSet-Spalten auf und wird von .NET Framework-Datenanbietern implementiert, die auf Datenquellen zugreifen.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Interface IDataParameterCollection
Inherits IList, ICollection, IEnumerable
'Usage
Dim instance As IDataParameterCollection
public interface IDataParameterCollection : IList, ICollection, IEnumerable
public interface class IDataParameterCollection : IList, ICollection, IEnumerable
public interface IDataParameterCollection extends IList, ICollection,
IEnumerable
public interface IDataParameterCollection extends IList, ICollection,
IEnumerable
Hinweise
Die IDataParameterCollection-Schnittstelle ermöglicht einer erbenden Klasse das Implementieren einer Parameterauflistung. Weitere Informationen über Parameterklassen finden Sie unter Verwenden von gespeicherten Prozeduren mit einem Befehl. Weitere Informationen über das Implementieren von .NET Framework-Datenanbietern finden Sie unter Implementing a .NET Framework Data Provider.
Eine Anwendung erstellt eine Instanz der IDataParameterCollection-Schnittstelle nicht direkt, sondern erstellt eine Instanz einer Klasse, die eine IDataParameterCollection-Schnittstelle erbt.
Klassen, die IDataParameterCollection-Schnittstellen erben, müssen die geerbten Member implementieren. Sie definieren i. d. R. zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen. Die IDataParameterCollection-Schnittstelle definiert z. B. eine Implementierung der RemoveAt-Methode. Die OleDbParameterCollection-Klasse erbt wiederum diese Methode und definiert zwei zusätzliche Überladungen von RemoveAt.
Hinweise für Implementierer Wenn Sie die IDataParameterCollection-Schnittstelle vererben, müssen Sie den folgenden Konstruktor implementieren:
Element |
Beschreibung |
|---|---|
PrvParameterCollection() |
Erstellt eine leere PrvParameterCollection-Klasse. |
Beispiel
Im folgenden Beispiel werden über die SqlParameterCollection-Auflistung in SqlDataAdapter mehrere Instanzen der abgeleiteten Klasse SqlParameter erstellt. Mithilfe dieser Parameter werden Daten aus der Datenquelle ausgewählt und in der DataSet-Klasse platziert. In diesem Beispiel wird davon ausgegangen, dass bereits eine DataSet-Klasse und eine SqlDataAdapter-Klasse mit dem entsprechenden Schema, den entsprechenden Befehlen sowie der entsprechenden Verbindung erstellt wurden.
Public Sub 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)
End Sub
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);
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0