SqlParameterCollection Klasse

Definition

Entspricht einer Auflistung von Parametern, die einem SqlCommand zugeordnet sind, sowie deren jeweiligen Zuordnungen zu Spalten in einem DataSet.Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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 von SqlParameter über die-Auflistung erstellt SqlParameterCollection .The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. Die Parameter werden verwendet, um Daten in der Datenquelle auszuwählen und das aufzufüllen DataSet .The parameters are used to select data within the data source and populate the DataSet. Bei diesem Code wird davon ausgegangen, dass ein DataSet und ein SqlDataAdapter bereits mit dem entsprechenden Schema, den Befehlen und der Verbindung erstellt wurden.This code assumes that a DataSet and a SqlDataAdapter have already been created with the appropriate schema, commands, and connection.

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 gespeicherten Prozedur Namen), muss die Anzahl der Parameter in der Auflistung gleich der Anzahl der Parameter Platzhalter im Befehls Text sein, oder SQL Server löst einen Fehler aus.If the command contains an ad hoc SQL statement, as opposed to a stored-procedure name, the number of the parameters in the collection must be equal to the number of parameter placeholders within the command text, or SQL Server raises an error. Bei einer gespeicherten Prozedur müssen alle Parameter, die in der gespeicherten Prozedur deklariert sind, ohne Standardwert angegeben werden.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. Parameter, die mit einem Standardwert deklariert werden, sind optional.Parameters declared with a default value are optional. Auf diese Weise können Sie einen anderen Wert als den Standardwert angeben.This lets you specify a value other than the default.

Weitere Informationen mit einem zusätzlichen Beispielcode, der die Verwendung von Parametern veranschaulicht, finden Sie unter Befehle und Parameter.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Eigenschaften

Count

Gibt eine ganze Zahl zurück, die die Anzahl der Elemente in der SqlParameterCollection enthält.Returns an Integer that contains the number of elements in the SqlParameterCollection. Schreibgeschützt.Read-only.

IsFixedSize

Ruft einen Wert ab, der angibt, ob die SqlParameterCollection eine feste Größe aufweist.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsFixedSize

Gibt an, ob die Auflistung eine feste Größe hat.Specifies whether the collection is a fixed size.

(Geerbt von DbParameterCollection)
IsReadOnly

Ruft einen Wert ab, der angibt, ob die SqlParameterCollection schreibgeschützt ist.Gets a value that indicates whether the SqlParameterCollection is read-only.

IsReadOnly

Gibt an, ob die Auflistung schreibgeschützt ist.Specifies whether the collection is read-only.

(Geerbt von DbParameterCollection)
IsSynchronized

Ruft einen Wert ab, der angibt, ob die SqlParameterCollection synchronisiert ist.Gets a value that indicates whether the SqlParameterCollection is synchronized.

IsSynchronized

Gibt an, ob die Auflistung synchronisiert wird.Specifies whether the collection is synchronized.

(Geerbt von DbParameterCollection)
Item[Int32]

Ruft den SqlParameter am angegebenen Index ab.Gets the SqlParameter at the specified index.

Item[String]

Ruft den SqlParameter mit dem angegebenen Namen ab.Gets the SqlParameter with the specified name.

SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf SqlParameterCollection synchronisiert werden kann.Gets an object that can be used to synchronize access to the SqlParameterCollection.

Methoden

Add(Object)

Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, Object)
Veraltet.
Veraltet.

Fügt dem SqlParameter-Objekt das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen und dem Datentyp hinzu.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, SqlDbType, Int32)

Fügt der SqlParameter einen SqlParameterCollection mit dem angegebenen Parameternamen, dem angegebenen SqlDbType und der angegebenen Größe hinzu.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String)

Fügt der SqlParameter einen SqlParameterCollection mit dem Parameternamen, dem Datentyp und der Spaltenlänge hinzu.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

AddRange(Array)

Fügt ein Array von Werten am Ende der SqlParameterCollection hinzu.Adds an array of values to the end of the SqlParameterCollection.

AddRange(SqlParameter[])

Fügt ein Array von SqlParameter-Werten am Ende der SqlParameterCollection hinzu.Adds an array of SqlParameter values to the end of the SqlParameterCollection.

AddWithValue(String, Object)

Fügt am Ende der SqlParameterCollection einen Wert hinzu.Adds a value to the end of the SqlParameterCollection.

Clear()

Entfernt alle SqlParameter-Objekte aus der SqlParameterCollection.Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object)

Bestimmt, ob der angegebene Object in dieser SqlParameterCollection vorhanden ist.Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter)

Bestimmt, ob der angegebene SqlParameter in dieser SqlParameterCollection vorhanden ist.Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String)

Bestimmt, ob der angegebene Parametername in diesem SqlParameterCollection ist.Determines whether the specified parameter name is in this SqlParameterCollection.

CopyTo(Array, Int32)

Kopiert alle Elemente der aktuellen SqlParameterCollection in das angegebene eindimensionale Array, beginnend am angegebenen Index des Ziel-Array.Copies all the elements of the current SqlParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

CopyTo(SqlParameter[], Int32)

Kopiert alle Elemente der aktuellen SqlParameterCollection in die angegebene SqlParameterCollection, beginnend am angegebenen Zielindex.Copies all the elements of the current SqlParameterCollection to the specified SqlParameterCollection starting at the specified destination index.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetEnumerator()

Gibt einen Enumerator zurück, der das SqlParameterCollection-Objekt durchläuft.Returns an enumerator that iterates through the SqlParameterCollection.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetParameter(Int32)

Gibt das DbParameter-Objekt am angegebenen Index in der Auflistung zurück.Returns the DbParameter object at the specified index in the collection.

(Geerbt von DbParameterCollection)
GetParameter(String)

Gibt das DbParameter-Objekt mit dem angegebenen Namen zurück.Returns DbParameter the object with the specified name.

(Geerbt von DbParameterCollection)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IndexOf(Object)

Ruft die Position der angegebenen Object in der Auflistung ab.Gets the location of the specified Object within the collection.

IndexOf(SqlParameter)

Ruft die Position der angegebenen SqlParameter in der Auflistung ab.Gets the location of the specified SqlParameter within the collection.

IndexOf(String)

Ruft die Position des angegebenen SqlParameter mit dem angegebenen Namen ab.Gets the location of the specified SqlParameter with the specified name.

InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
Insert(Int32, Object)

Fügt ein Object am angegebenen Index in die SqlParameterCollection ein.Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter)

Fügt ein SqlParameter-Objekt am angegebenen Index in die SqlParameterCollection ein.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
Remove(Object)

Entfernt den angegebenen SqlParameter aus der Auflistung.Removes the specified SqlParameter from the collection.

Remove(SqlParameter)

Entfernt den angegebenen SqlParameter aus der Auflistung.Removes the specified SqlParameter from the collection.

RemoveAt(Int32)

Entfernt den SqlParameter am angegebenen Index aus der SqlParameterCollection.Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String)

Entfernt den SqlParameter am angegebenen Parameternamen aus der SqlParameterCollection.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

SetParameter(Int32, DbParameter)

Legt das DbParameter-Objekt am angegebenen Index auf einen neuen Wert fest.Sets the DbParameter object at the specified index to a new value.

(Geerbt von DbParameterCollection)
SetParameter(String, DbParameter)

Legt das DbParameter-Objekt mit dem angegebenen Namen auf einen neuen Wert fest.Sets the DbParameter object with the specified name to a new value.

(Geerbt von DbParameterCollection)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert (threadsicher) ist.Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Geerbt von DbParameterCollection)
IDataParameterCollection.Item[String]

Ruft den Parameter am angegebenen Index ab oder legt diesen fest.Gets or sets the parameter at the specified index.

(Geerbt von DbParameterCollection)
IList.Add(Object)

Eine Beschreibung dieses Elements finden Sie unter Add(Object).For a description of this member, see Add(Object).

(Geerbt von DbParameterCollection)
IList.Contains(Object)

Eine Beschreibung dieses Elements finden Sie unter Contains(Object).For a description of this member, see Contains(Object).

(Geerbt von DbParameterCollection)
IList.IndexOf(Object)

Eine Beschreibung dieses Elements finden Sie unter IndexOf(Object).For a description of this member, see IndexOf(Object).

(Geerbt von DbParameterCollection)
IList.Insert(Int32, Object)

Eine Beschreibung dieses Elements finden Sie unter Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

(Geerbt von DbParameterCollection)
IList.IsFixedSize

Ruft einen Wert ab, der angibt, ob das IList eine feste Größe aufweist.Gets a value indicating whether the IList has a fixed size.

(Geerbt von DbParameterCollection)
IList.IsReadOnly

Ruft einen Wert ab, der angibt, ob das IList schreibgeschützt ist.Gets a value indicating whether the IList is read-only.

(Geerbt von DbParameterCollection)
IList.Item[Int32]

Ruft das Element am angegebenen Index ab oder legt dieses fest.Gets or sets the element at the specified index.

(Geerbt von DbParameterCollection)
IList.Remove(Object)

Eine Beschreibung dieses Elements finden Sie unter Remove(Object).For a description of this member, see Remove(Object).

(Geerbt von DbParameterCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Weitere Informationen