SqlParameterCollection Klasse

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

[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

DbParameterCollection

SqlParameterCollection

Attribute

ListBindableAttribute

Beispiele

Im folgenden Beispiel werden mehrere Instanzen von SqlParameter über die SqlParameterCollection Auflistung erstellt. Die Parameter werden verwendet, um Daten in der Datenquelle auszuwählen und die aufzufüllen DataSet. Bei diesem Code wird davon ausgegangen, dass ein DataSet und bereits SqlDataAdapter mit dem entsprechenden Schema, den entsprechenden Befehlen und der entsprechenden Verbindung erstellt wurden.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


    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);

    }
}

Hinweise

Wenn der Befehl eine Ad-hoc-SQL-Anweisung im Gegensatz zu einem Namen einer gespeicherten Prozedur enthält, 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 angegeben werden. Parameter, die mit einem Standardwert deklariert werden, sind optional. Dadurch können Sie einen anderen Wert als den Standardwert angeben.

Weitere Informationen mit zusätzlichem Beispielcode, der die Verwendung von Parametern veranschaulicht, finden Sie unter Befehle und Parameter.

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.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die SqlParameterCollection schreibgeschützt ist.
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, 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.
GetEnumerator()	Gibt einen Enumerator zurück, der die SqlParameterCollection durchläuft.
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.
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.
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.