SqlParameterCollection Klasse

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Vererbung

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

Attribute

ListBindableAttribute

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	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection synchronisiert ist.
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, Object)	Veraltet. 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.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
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)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
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.
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
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)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
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)

Explizite Schnittstellenimplementierungen

IDataParameterCollection.Item[String]	Ruft den Parameter am angegebenen Index ab oder legt diesen fest. (Geerbt von DbParameterCollection)
IList.Item[Int32]	Ruft das Element am angegebenen Index ab oder legt dieses fest. (Geerbt von DbParameterCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Weitere Informationen

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