Freigeben über


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

Siehe auch

Referenz

IDataParameterCollection-Member
System.Data-Namespace