SqlParameterCollection Klasse

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Stellt eine Auflistung von Parametern dar, die einer SqlCommand und ihren jeweiligen Zuordnungen zu Spalten in einer .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 der SqlParameterSqlParameterCollection Auflistung erstellt. Die Parameter werden verwendet, um Daten in der Datenquelle auszuwählen und die DataSet. Dieser Code geht davon aus, dass ein DataSet und eine SqlDataAdapter bereits mit dem entsprechenden Schema, den entsprechenden Befehlen und der Verbindung erstellt wurde.

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 eine AD-hoc-SQL-Anweisung enthält, im Gegensatz zu einem Namen einer gespeicherten Prozedur, muss die Anzahl der Parameter in der Auflistung der Anzahl der Parameterplatzhalter innerhalb des Befehlstexts entsprechen, oder SQL Server einen Fehler auslöst. Bei einer gespeicherten Prozedur müssen alle in der gespeicherten Prozedur deklarierten Parameter ohne Standardwert bereitgestellt werden. Parameter, die mit einem Standardwert deklariert werden, sind optional. Auf diese Weise können Sie einen anderen Wert als den Standardwert angeben.

Weitere Informationen mit zusätzlichem Beispielcode zur Verwendung von Parametern finden Sie unter "Befehle und Parameter".

Eigenschaften

Name	Beschreibung
Count	Gibt eine ganze Zahl zurück, die die Anzahl der Elemente in der SqlParameterCollection. Schreibgeschützt
IsFixedSize	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection eine feste Größe aufweist.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection schreibgeschützt ist.
IsSynchronized	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection Synchronisierung erfolgt.
Item[Int32]	Ruft den SqlParameter am angegebenen Index ab.
Item[String]	Ruft den SqlParameter mit dem angegebenen Namen ab.
SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die SqlParameterCollectionverwendet werden kann.

Methoden

Name	Beschreibung
Add(Object)	Fügt das angegebene SqlParameter Objekt dem SqlParameterCollection.
Add(SqlParameter)	Fügt das angegebene SqlParameter Objekt dem SqlParameterCollection.
Add(String, Object)	Veraltet. Fügt das angegebene SqlParameter Objekt dem SqlParameterCollection.
Add(String, SqlDbType, Int32, String)	Fügt dem SqlParameterCollection Parameternamen, dem Datentyp und der Spaltenlänge einen SqlParameter Wert hinzu.
Add(String, SqlDbType, Int32)	Fügt dem angegebenen Parameternamen SqlDbType und der Angegebenen Größe einen Wert SqlParameterSqlParameterCollectionhinzu.
Add(String, SqlDbType)	Fügt dem SqlParameterCollection angegebenen Parameternamen und dem Datentyp einen SqlParameter Wert hinzu.
AddRange(Array)	Fügt am Ende des Werts SqlParameterCollectionein Array von Werten hinzu.
AddRange(SqlParameter[])	Fügt am Ende des Werts SqlParameterein Array von SqlParameterCollection Werten hinzu.
AddWithValue(String, Object)	Addiert einen Wert am Ende der .SqlParameterCollection
Clear()	Entfernt alle SqlParameter Objekte aus dem SqlParameterCollection.
Contains(Object)	Bestimmt, ob der angegebene Wert in dieser ObjectDatei enthalten SqlParameterCollection ist.
Contains(SqlParameter)	Bestimmt, ob der angegebene Wert in dieser SqlParameterDatei enthalten SqlParameterCollection ist.
Contains(String)	Bestimmt, ob sich der angegebene Parametername in dieser SqlParameterCollectionDatei befindet.
CopyTo(Array, Int32)	Kopiert alle Elemente des aktuellen SqlParameterCollection Elements an den angegebenen eindimensionalen Array Anfang am angegebenen Zielindex Array .
CopyTo(SqlParameter[], Int32)	Kopiert alle Elemente des aktuellen SqlParameterCollection Elements an den angegebenen SqlParameterCollection Anfang am angegebenen Zielindex.
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (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 durch die SqlParameterCollectionEnumerator durchläuft.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie 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 DbParameter das Objekt mit dem angegebenen Namen zurück. (Geerbt von DbParameterCollection)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Object)	Ruft den Speicherort der angegebenen innerhalb der Auflistung ab Object .
IndexOf(SqlParameter)	Ruft den Speicherort der angegebenen innerhalb der Auflistung ab SqlParameter .
IndexOf(String)	Ruft die Position des angegebenen SqlParameter Mit dem angegebenen Namen ab.
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
Insert(Int32, Object)	Fügt eine Object in den SqlParameterCollection angegebenen Index ein.
Insert(Int32, SqlParameter)	Fügt ein SqlParameter Objekt in den SqlParameterCollection angegebenen Index ein.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject)
Remove(Object)	Entfernt den angegebenen SqlParameter Wert aus der Auflistung.
Remove(SqlParameter)	Entfernt den angegebenen SqlParameter Wert aus der Auflistung.
RemoveAt(Int32)	Entfernt den SqlParameter Wert aus dem SqlParameterCollection am angegebenen Index angegebenen Index.
RemoveAt(String)	Entfernt den SqlParameter Wert aus dem SqlParameterCollection angegebenen Parameternamen.
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

Name	Beschreibung
IDataParameterCollection.Item[String]	Dient zum Abrufen oder Festlegen des Parameters am angegebenen Index. (Geerbt von DbParameterCollection)
IList.Item[Int32]	Ruft das Element am angegebenen Index ab oder legt es fest. (Geerbt von DbParameterCollection)

Erweiterungsmethoden

Name	Beschreibung
AsParallel(IEnumerable)	Aktiviert die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Wandelt eine IEnumerable in eine IQueryableum.
Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.
OfType<TResult>(IEnumerable)	Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.

Weitere Informationen

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