SqlParameterCollection Klasse

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Entspricht einer Auflistung von Parametern, die einem SqlCommand zugeordnet sind, sowie deren jeweiligen Zuordnungen zu Spalten in einem DataSet. Diese Klasse kann nicht vererbt werden.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection

public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Vererbung

Object

DbParameterCollection

SqlParameterCollection

Beispiele

Im folgenden Beispiel werden mehrere Instanzen von SqlParameter über die SqlParameterCollection Auflistung erstellt. Die Parameter werden verwendet, um Daten in der Datenquelle auszuwählen und die aufzufüllen DataSet. Bei diesem Code wird davon ausgegangen, dass ein DataSet und bereits SqlDataAdapter mit dem entsprechenden Schema, den entsprechenden Befehlen und der entsprechenden Verbindung 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);
}

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

Hinweise

Wenn der Befehl im Gegensatz zu einem Namen einer gespeicherten Prozedur eine Ad-hoc-SQL-Anweisung enthält, muss die Anzahl der Parameter in der Auflistung der Anzahl der Parameterplatzhalter im Befehlstext entsprechen, oder SQL Server einen Fehler auslöst. Bei einer gespeicherten Prozedur müssen alle In der gespeicherten Prozedur deklarierten Parameter ohne Standardwert angegeben werden. Parameter, die mit einem Standardwert deklariert werden, sind optional. Dadurch können Sie einen anderen Wert als den Standardwert angeben.

Weitere Informationen mit zusätzlichem Beispielcode, der die Verwendung von Parametern veranschaulicht, finden Sie unter Befehle und Parameter.

Eigenschaften

Count	Gibt eine ganze Zahl zurück, die die Anzahl der Elemente in der SqlParameterCollection enthält. Schreibgeschützt.
IsFixedSize	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection eine feste Größe hat.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection schreibgeschützt ist.
IsSynchronized	Gibt an, ob die Auflistung synchronisiert wird. (Geerbt von DbParameterCollection)
Item[Int32]	Ruft den SqlParameter am angegebenen Index ab.
Item[String]	Ruft den SqlParameter mit dem angegebenen Namen ab.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf SqlParameterCollection synchronisiert werden kann.

Methoden

Add(Object)	Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.
Add(SqlParameter)	Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.
Add(String, SqlDbType)	Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen und dem Datentyp hinzu.
Add(String, SqlDbType, Int32)	Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen, dem angegebenen SqlDbType und der angegebenen Größe hinzu.
Add(String, SqlDbType, Int32, String)	Fügt der SqlParameter einen SqlParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.
AddRange(Array)	Fügt ein Array von Werten am Ende der SqlParameterCollection hinzu.
AddRange(SqlParameter[])	Fügt ein Array von SqlParameter-Werten am Ende der SqlParameterCollection hinzu.
AddWithValue(String, Object)	Fügt am Ende der SqlParameterCollection einen Wert hinzu.
Clear()	Entfernt alle SqlParameter-Objekte aus der SqlParameterCollection.
Contains(Object)	Bestimmt, ob der angegebene Object in dieser SqlParameterCollection vorhanden ist.
Contains(SqlParameter)	Bestimmt, ob der angegebene SqlParameter in dieser SqlParameterCollection vorhanden ist.
Contains(String)	Bestimmt, ob der angegebene Parametername in diesem SqlParameterCollection ist.
CopyTo(Array, Int32)	Kopiert alle Elemente der aktuellen SqlParameterCollection in das angegebene eindimensionale Array, beginnend am angegebenen Index des Ziel-Array.
CopyTo(SqlParameter[], Int32)	Kopiert alle Elemente der aktuellen SqlParameterCollection in die angegebene SqlParameterCollection, beginnend am angegebenen Zielindex.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt einen Enumerator zurück, der die SqlParameterCollection durchläuft.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetParameter(Int32)	Gibt das DbParameter-Objekt am angegebenen Index in der Auflistung zurück. (Geerbt von DbParameterCollection)
GetParameter(String)	Gibt das DbParameter-Objekt mit dem angegebenen Namen zurück. (Geerbt von DbParameterCollection)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Object)	Ruft die Position der angegebenen Object in der Auflistung ab.
IndexOf(SqlParameter)	Ruft die Position der angegebenen SqlParameter in der Auflistung ab.
IndexOf(String)	Ruft die Position des angegebenen SqlParameter mit dem angegebenen Namen ab.
Insert(Int32, Object)	Fügt ein Object am angegebenen Index in die SqlParameterCollection ein.
Insert(Int32, SqlParameter)	Fügt ein SqlParameter-Objekt am angegebenen Index in die SqlParameterCollection ein.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(Object)	Entfernt den angegebenen SqlParameter aus der Auflistung.
Remove(SqlParameter)	Entfernt den angegebenen SqlParameter aus der Auflistung.
RemoveAt(Int32)	Entfernt den SqlParameter am angegebenen Index aus der SqlParameterCollection.
RemoveAt(String)	Entfernt den SqlParameter am angegebenen Parameternamen aus der SqlParameterCollection.
SetParameter(Int32, DbParameter)	Legt das DbParameter-Objekt am angegebenen Index auf einen neuen Wert fest. (Geerbt von DbParameterCollection)
SetParameter(String, DbParameter)	Legt das DbParameter-Objekt mit dem angegebenen Namen auf einen neuen Wert fest. (Geerbt von DbParameterCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Erweiterungsmethoden

Weitere Informationen

• Befehle und Parameter (ADO.NET)
• DataAdapter-Parameter (ADO.NET)
• Verwenden des .NET Framework-Datenanbieters für SQL Server
• Übersicht über ADO.NET