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.

Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.

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 Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
IsFixedSize	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection eine feste Größe aufweist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection schreibgeschützt ist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
IsSynchronized	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection Synchronisierung erfolgt. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Item[Int32]	Ruft den SqlParameter am angegebenen Index ab. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Item[String]	Ruft den SqlParameter mit dem angegebenen Namen ab. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die SqlParameterCollectionverwendet werden kann. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.

Methoden

Name	Beschreibung
Add(Object)	Fügt das angegebene SqlParameter Objekt dem SqlParameterCollection. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Add(SqlParameter)	Fügt das angegebene SqlParameter Objekt dem SqlParameterCollection. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Add(String, Object)	Veraltet. Fügt das angegebene SqlParameter Objekt dem SqlParameterCollection. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Add(String, SqlDbType, Int32, String)	Fügt dem SqlParameter Parameternamen, dem Datentyp und der Spaltenlänge einen SqlParameterCollection Wert hinzu. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Add(String, SqlDbType, Int32)	Fügt dem angegebenen Parameternamen SqlParameter und der Angegebenen Größe einen Wert SqlParameterCollectionSqlDbTypehinzu. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Add(String, SqlDbType)	Fügt dem SqlParameter angegebenen Parameternamen und dem Datentyp einen SqlParameterCollection Wert hinzu. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
AddRange(Array)	Fügt am Ende des Werts SqlParameterCollectionein Array von Werten hinzu. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
AddRange(SqlParameter[])	Fügt am Ende des Werts SqlParameterein Array von SqlParameterCollection Werten hinzu. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
AddWithValue(String, Object)	Addiert einen Wert am Ende der .SqlParameterCollection Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Clear()	Entfernt alle SqlParameter Objekte aus dem SqlParameterCollection. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Contains(Object)	Bestimmt, ob der angegebene Wert in dieser ObjectDatei enthalten SqlParameterCollection ist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Contains(SqlParameter)	Bestimmt, ob der angegebene Wert in dieser SqlParameterDatei enthalten SqlParameterCollection ist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Contains(String)	Bestimmt, ob sich der angegebene Parametername in dieser SqlParameterCollectionDatei befindet. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
CopyTo(Array, Int32)	Kopiert alle Elemente des aktuellen SqlParameterCollection Elements an den angegebenen eindimensionalen Array Anfang am angegebenen Zielindex Array . Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
CopyTo(SqlParameter[], Int32)	Kopiert alle Elemente des aktuellen SqlParameterCollection Elements an den angegebenen SqlParameterCollection Anfang am angegebenen Zielindex. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
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 dem aktuellen Objekt entspricht. (Geerbt von Object)
GetEnumerator()	Gibt einen Enumerator zurück, der durch die SqlParameterCollectionEnumerator durchläuft. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
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 . Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
IndexOf(SqlParameter)	Ruft den Speicherort der angegebenen innerhalb der Auflistung ab SqlParameter . Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
IndexOf(String)	Ruft die Position des angegebenen SqlParameter Mit dem angegebenen Namen ab. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
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. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Insert(Int32, SqlParameter)	Fügt ein SqlParameter Objekt in den SqlParameterCollection angegebenen Index ein. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
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. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Remove(SqlParameter)	Entfernt den angegebenen SqlParameter Wert aus der Auflistung. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
RemoveAt(Int32)	Entfernt den SqlParameter Wert aus dem SqlParameterCollection am angegebenen Index angegebenen Index. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
RemoveAt(String)	Entfernt den SqlParameter Wert aus dem SqlParameterCollection angegebenen Parameternamen. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
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.

Siehe auch

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