SqlParameterCollection Classe

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Représente une collection de paramètres associés à un SqlCommand et leurs mappages respectifs aux colonnes d’un DataSet. Cette classe ne peut pas être héritée.

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

Héritage

DbParameterCollection

SqlParameterCollection

Attributs

ListBindableAttribute

Exemples

L’exemple suivant crée plusieurs instances de SqlParameter via la SqlParameterCollection collection. Les paramètres sont utilisés pour sélectionner des données dans la source de données et remplir le DataSet. Ce code suppose qu’un DataSet et un SqlDataAdapter ont déjà été créés avec le schéma, les commandes et la connexion appropriés.

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

    }
}

Remarques

Si la commande contient une instruction SQL ad hoc, par opposition à un nom de procédure stockée, le nombre de paramètres de la collection doit être égal au nombre d’espaces réservés de paramètres dans le texte de la commande, ou SQL Server génère une erreur. Avec une procédure stockée, tous les paramètres déclarés dans la procédure stockée sans valeur par défaut doivent être fournis. Les paramètres déclarés avec une valeur par défaut sont facultatifs. Cela vous permet de spécifier une valeur autre que la valeur par défaut.

Pour plus d’informations avec un exemple de code supplémentaire illustrant l’utilisation des paramètres, consultez Commandes et paramètres.

Propriétés

Count	Retourne un entier qui contient le nombre d'éléments dans SqlParameterCollection. Lecture seule.
IsFixedSize	Obtient une valeur qui indique si SqlParameterCollection est de taille fixe.
IsReadOnly	Obtient une valeur qui indique si l’objet SqlParameterCollection est en lecture seule.
Item[Int32]	Obtient l'objet SqlParameter à l'index spécifié.
Item[String]	Obtient l'objet SqlParameter portant le nom spécifié.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à SqlParameterCollection.

Méthodes

Add(Object)	Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.
Add(SqlParameter)	Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.
Add(String, SqlDbType)	Ajoute un objet SqlParameter à SqlParameterCollection en fonction du nom du paramètre et du type de données.
Add(String, SqlDbType, Int32)	Ajoute un SqlParameter à SqlParameterCollection, en fonction du nom de paramètre, du SqlDbType et de la taille spécifiés.
Add(String, SqlDbType, Int32, String)	Ajoute un objet SqlParameter à SqlParameterCollection avec le nom du paramètre, le type de données et la longueur de la colonne.
AddRange(Array)	Ajoute un tableau de valeurs à la fin de l'objet SqlParameterCollection.
AddRange(SqlParameter[])	Ajoute un tableau de valeurs SqlParameter à la fin de l'objet SqlParameterCollection.
AddWithValue(String, Object)	Ajoute une valeur à la fin de l'objet SqlParameterCollection.
Clear()	Supprime tous les objets SqlParameter de SqlParameterCollection.
Contains(Object)	Détermine si l'objet Object spécifié se trouve dans cet objet SqlParameterCollection.
Contains(SqlParameter)	Détermine si l'objet SqlParameter spécifié se trouve dans cet objet SqlParameterCollection.
Contains(String)	Détermine si le nom de paramètre spécifié se trouve dans cette SqlParameterCollection.
CopyTo(Array, Int32)	Copie tous les éléments de l'objet SqlParameterCollection actuel dans le Array unidimensionnel spécifié, à partir de l'index Array de destination spécifié.
CopyTo(SqlParameter[], Int32)	Copie tous les éléments de l'objet SqlParameterCollection actuel dans l'objet SqlParameterCollection spécifié à partir de l'index de destination donné.
GetEnumerator()	Retourne un énumérateur qui itère au sein de SqlParameterCollection.
IndexOf(Object)	Obtient l'emplacement du Object spécifié dans la collection.
IndexOf(SqlParameter)	Obtient l'emplacement du SqlParameter spécifié dans la collection.
IndexOf(String)	Obtient l'emplacement de l'objet SqlParameter spécifié portant le nom donné.
Insert(Int32, Object)	Insère un objet Object dans SqlParameterCollection à l'index spécifié.
Insert(Int32, SqlParameter)	Insère un objet SqlParameter dans SqlParameterCollection à l'index spécifié.
Remove(Object)	Supprime l’objet SqlParameter spécifié de la collection.
Remove(SqlParameter)	Supprime l’objet SqlParameter spécifié de la collection.
RemoveAt(Int32)	Supprime l'objet SqlParameter de l'objet SqlParameterCollection à l'index spécifié.
RemoveAt(String)	Supprime l'objet SqlParameter de l'objet SqlParameterCollection au niveau du nom de paramètre spécifié.