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

Beispiele

Im folgenden Beispiel werden mehrere Instanzen von SqlParameter über die SqlParameterCollection Auflistung erstellt.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. Die Parameter werden verwendet, um Daten in der Datenquelle auszuwählen und die DataSetaufzufüllen.The parameters are used to select data within the data source and populate the DataSet. Bei diesem Code wird davon ausgegangen, dass bereits eine DataSet und eine SqlDataAdapter 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 hat.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsReadOnly

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

IsSynchronized

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

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 der SqlParameter das angegebene SqlParameterCollection-Objekt hinzu.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

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

Add(String, Object)

Fügt der SqlParameter 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 die SqlParameterCollection 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)
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.

ToString()

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

(Geerbt von Object)

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:

Siehe auch