SqlParameterCollection Classe

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

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

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

Attributs

ListBindableAttribute

Exemples

L’exemple suivant crée plusieurs instances de SqlParameter la SqlParameterCollection collection. Les paramètres sont utilisés pour sélectionner des données dans la source de données et remplir le DataSetfichier . 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.

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

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 comment utiliser des paramètres, consultez Commandes et paramètres.

Propriétés

Nom	Description
Count	Retourne un entier qui contient le nombre d’éléments dans le SqlParameterCollection. Lecture seule.
IsFixedSize	Obtient une valeur qui indique si la SqlParameterCollection taille fixe est définie.
IsReadOnly	Obtient une valeur qui indique si l’objet SqlParameterCollection est en lecture seule.
IsSynchronized	Obtient une valeur qui indique si la SqlParameterCollection synchronisation est effectuée.
Item[Int32]	Obtient l’index SqlParameter spécifié.
Item[String]	Obtient le SqlParameter nom spécifié.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès au SqlParameterCollection.

Méthodes

Nom	Description
Add(Object)	Ajoute l’objet spécifié SqlParameter à l’objet SqlParameterCollection.
Add(SqlParameter)	Ajoute l’objet spécifié SqlParameter à l’objet SqlParameterCollection.
Add(String, Object)	Obsolète. Ajoute l’objet spécifié SqlParameter à l’objet SqlParameterCollection.
Add(String, SqlDbType, Int32, String)	Ajoute un SqlParameter au nom du paramètre, au type de données et à SqlParameterCollection la longueur de la colonne.
Add(String, SqlDbType, Int32)	Ajoute un SqlParameter au paramètre , en fonction du SqlParameterCollectionnom SqlDbType et de la taille du paramètre spécifiés.
Add(String, SqlDbType)	Ajoute un SqlParameter au SqlParameterCollection nom du paramètre donné et au type de données.
AddRange(Array)	Ajoute un tableau de valeurs à la fin du SqlParameterCollection.
AddRange(SqlParameter[])	Ajoute un tableau de SqlParameter valeurs à la fin du SqlParameterCollection.
AddWithValue(String, Object)	Ajoute une valeur à la fin du SqlParameterCollection.
Clear()	Supprime tous les SqlParameter objets du SqlParameterCollection.
Contains(Object)	Détermine si le spécifié Object se trouve dans ce SqlParameterCollectionfichier .
Contains(SqlParameter)	Détermine si le spécifié SqlParameter se trouve dans ce SqlParameterCollectionfichier .
Contains(String)	Détermine si le nom de paramètre spécifié se trouve dans ce SqlParameterCollectionfichier .
CopyTo(Array, Int32)	Copie tous les éléments du courant SqlParameterCollection vers le point de départ unidimensionnel Array spécifié à partir de l’index de destination Array spécifié.
CopyTo(SqlParameter[], Int32)	Copie tous les éléments du courant SqlParameterCollection vers le début spécifié SqlParameterCollection à l’index de destination spécifié.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un énumérateur qui itère dans le SqlParameterCollection.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetParameter(Int32)	Retourne l’objet DbParameter à l’index spécifié dans la collection. (Hérité de DbParameterCollection)
GetParameter(String)	Retourne DbParameter l’objet portant le nom spécifié. (Hérité de DbParameterCollection)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IndexOf(Object)	Obtient l’emplacement du fichier spécifié Object dans la collection.
IndexOf(SqlParameter)	Obtient l’emplacement du fichier spécifié SqlParameter dans la collection.
IndexOf(String)	Obtient l’emplacement du spécifié SqlParameter avec le nom spécifié.
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Insert(Int32, Object)	Insère un Object dans l’index SqlParameterCollection spécifié.
Insert(Int32, SqlParameter)	Insère un SqlParameter objet dans l’index SqlParameterCollection spécifié.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
Remove(Object)	Supprime le spécifié SqlParameter de la collection.
Remove(SqlParameter)	Supprime le spécifié SqlParameter de la collection.
RemoveAt(Int32)	Supprime la SqlParameter valeur de l’index SqlParameterCollection spécifié.
RemoveAt(String)	Supprime le SqlParameterSqlParameterCollection nom du paramètre spécifié.
SetParameter(Int32, DbParameter)	Définit l’objet DbParameter à l’index spécifié sur une nouvelle valeur. (Hérité de DbParameterCollection)
SetParameter(String, DbParameter)	Définit l’objet DbParameter avec le nom spécifié sur une nouvelle valeur. (Hérité de DbParameterCollection)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
IDataParameterCollection.Item[String]	Obtient ou définit le paramètre à l’index spécifié. (Hérité de DbParameterCollection)
IList.Item[Int32]	Obtient ou définit l’élément à l’index spécifié. (Hérité de DbParameterCollection)

Méthodes d’extension

Nom	Description
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

Voir aussi

• Commandes et paramètres (ADO.NET)
• Paramètres DataAdapter (ADO.NET)
• Utilisation du fournisseur de données .NET Framework pour SQL Server
• Vue d'ensemble d’ADO.NET