SqlParameterCollection-Klasse

Artikel
08/20/2007

Stellt eine Auflistung von Parametern dar, die einem SqlCommand zugeordnet sind, sowie deren jeweilige Zuordnung zu Spalten in einem DataSet. Diese Klasse kann nicht vererbt werden.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public NotInheritable Class SqlParameterCollection
    Inherits DbParameterCollection
'Usage
Dim instance As SqlParameterCollection

public sealed class SqlParameterCollection : DbParameterCollection

public ref class SqlParameterCollection sealed : public DbParameterCollection

public final class SqlParameterCollection extends DbParameterCollection

public final class SqlParameterCollection extends DbParameterCollection

Hinweise

Wenn der Befehl eine spontane SQL-Anweisung und keinen Namen einer gespeicherten Prozedur enthält, muss die Anzahl der Parameter in der Auflistung mit der Anzahl der Parameterplatzhalter im Befehlstext übereinstimmen, andernfalls löst SQL Server einen Fehler aus. Bei einer gespeicherten Prozedur müssen alle in der gespeicherten Prozedur ohne einen Standardwert deklarierten Parameter bereitgestellt werden. Mit einem Standardwert deklarierte Parameter sind optional. So können Sie einen anderen als den Standardwert angeben.

Beispiel

Im folgenden Beispiel werden über die SqlParameterCollection-Auflistung mehrere Instanzen von SqlParameter erstellt. Diese Parameter werden zum Auswählen von Daten innerhalb der Datenquelle und zum Auffüllen des DataSet verwendet. In diesem Code wird davon ausgegangen, dass bereits ein DataSet und ein SqlDataAdapter 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);

}

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameterCollection
      System.Data.SqlClient.SqlParameterCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

SqlParameterCollection-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server

Freigeben über