SqlParameterCollection Klasse

Definition

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 ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
type SqlParameterCollection = class
    inherit DbParameterCollection
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
Vererbung
SqlParameterCollection
Vererbung
Vererbung
SqlParameterCollection
Attribute
Implementiert

Beispiele

Im folgenden Beispiel werden mehrere Instanzen der SqlParameter SqlParameterCollection Auflistung erstellt. Die Parameter werden verwendet, um Daten in der Datenquelle auszuwählen und die DataSet. Dieser Code geht davon aus, dass eine und eine DataSet SqlDataAdapter bereits mit dem entsprechenden Schema, Befehlen und Verbindungen 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 der gespeicherten Prozedur, muss die Anzahl der Parameter in der Auflistung gleich der Anzahl der Parameterplatzhalter innerhalb des Befehlstexts sein, 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 Befehlen und Parametern.

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.

IsFixedSize

Gibt an, ob die Auflistung eine feste Größe hat.

(Geerbt von DbParameterCollection)
IsReadOnly

Ruft einen Wert ab, der angibt, ob die SqlParameterCollection schreibgeschützt ist.

IsReadOnly

Gibt an, ob die Auflistung schreibgeschützt ist.

(Geerbt von DbParameterCollection)
IsSynchronized

Ruft einen Wert ab, der angibt, ob die SqlParameterCollection synchronisiert 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, Object)
Veraltet.
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()
Veraltet.

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()
Veraltet.

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

ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert (threadsicher) ist.

(Geerbt von DbParameterCollection)
IDataParameterCollection.Item[String]

Ruft den Parameter am angegebenen Index ab oder legt diesen fest.

(Geerbt von DbParameterCollection)
IList.IsFixedSize

Ruft einen Wert ab, der angibt, ob das IList eine feste Größe aufweist.

(Geerbt von DbParameterCollection)
IList.IsReadOnly

Ruft einen Wert ab, der angibt, ob das IList schreibgeschützt ist.

(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.

Gilt für:

Siehe auch