SqlParameterCollection Classe

Définition

Représente une collection de paramètres associés à un SqlCommand et leurs mappages respectifs aux colonnes d’un DataSet.Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. Cette classe ne peut pas être héritée.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
Héritage
SqlParameterCollection
Attributs
Implémente

Exemples

L’exemple suivant crée plusieurs instances de SqlParameter via la collection SqlParameterCollection.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. Les paramètres sont utilisés pour sélectionner des données dans la source de données et remplir le DataSet.The parameters are used to select data within the data source and populate the 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.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  

Remarques

Si la commande contient une instruction SQL ad hoc, par opposition à un nom de procédure stockée, le nombre de paramètres dans la collection doit être égal au nombre d’espaces réservés de paramètre dans le texte de la commande, ou SQL Server génère une erreur.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. 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.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. Les paramètres déclarés avec une valeur par défaut sont facultatifs.Parameters declared with a default value are optional. Cela vous permet de spécifier une valeur autre que la valeur par défaut.This lets you specify a value other than the default.

Pour plus d’informations sur des exemples de code supplémentaires illustrant l’utilisation des paramètres, consultez commandes et paramètres.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Propriétés

Count

Retourne un entier qui contient le nombre d'éléments dans SqlParameterCollection.Returns an Integer that contains the number of elements in the SqlParameterCollection. Lecture seule.Read-only.

IsFixedSize

Obtient une valeur qui indique si SqlParameterCollection est de taille fixe.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsReadOnly

Obtient une valeur qui indique si l'objet SqlParameterCollection est en lecture seule.Gets a value that indicates whether the SqlParameterCollection is read-only.

IsSynchronized

Obtient une valeur qui indique si l’objet SqlParameterCollection est synchronisé.Gets a value that indicates whether the SqlParameterCollection is synchronized.

Item[Int32]

Obtient l'objet SqlParameter à l'index spécifié.Gets the SqlParameter at the specified index.

Item[String]

Obtient l'objet SqlParameter portant le nom spécifié.Gets the SqlParameter with the specified name.

SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à SqlParameterCollection.Gets an object that can be used to synchronize access to the SqlParameterCollection.

Méthodes

Add(Object)

Ajoute l'objet SqlParameter spécifié à SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

Ajoute l'objet SqlParameter spécifié à SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, Object)

Ajoute l'objet SqlParameter spécifié à SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType)

Ajoute un objet SqlParameter à SqlParameterCollection en fonction du nom du paramètre et du type de données.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, SqlDbType, Int32)

Ajoute un SqlParameter à SqlParameterCollection, en fonction du nom de paramètre, du SqlDbType et de la taille spécifiés.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

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.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

AddRange(Array)

Ajoute un tableau de valeurs à la fin de l'objet SqlParameterCollection.Adds an array of values to the end of the SqlParameterCollection.

AddRange(SqlParameter[])

Ajoute un tableau de valeurs SqlParameter à la fin de l'objet SqlParameterCollection.Adds an array of SqlParameter values to the end of the SqlParameterCollection.

AddWithValue(String, Object)

Ajoute une valeur à la fin de l'objet SqlParameterCollection.Adds a value to the end of the SqlParameterCollection.

Clear()

Supprime tous les objets SqlParameter de SqlParameterCollection.Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object)

Détermine si l'objet Object spécifié se trouve dans cet objet SqlParameterCollection.Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter)

Détermine si l'objet SqlParameter spécifié se trouve dans cet objet SqlParameterCollection.Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String)

Détermine si le nom de paramètre spécifié se trouve dans cette SqlParameterCollection.Determines whether the specified parameter name is in this 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é.Copies all the elements of the current SqlParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

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é.Copies all the elements of the current SqlParameterCollection to the specified SqlParameterCollection starting at the specified destination index.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Retourne un énumérateur qui itère au sein de SqlParameterCollection.Returns an enumerator that iterates through the SqlParameterCollection.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IndexOf(Object)

Obtient l'emplacement du Object spécifié dans la collection.Gets the location of the specified Object within the collection.

IndexOf(SqlParameter)

Obtient l'emplacement du SqlParameter spécifié dans la collection.Gets the location of the specified SqlParameter within the collection.

IndexOf(String)

Obtient l'emplacement de l'objet SqlParameter spécifié portant le nom donné.Gets the location of the specified SqlParameter with the specified name.

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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
Insert(Int32, Object)

Insère un objet Object dans SqlParameterCollection à l'index spécifié.Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter)

Insère un objet SqlParameter dans SqlParameterCollection à l'index spécifié.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
Remove(Object)

Supprime l’objet SqlParameter spécifié de la collection.Removes the specified SqlParameter from the collection.

Remove(SqlParameter)

Supprime l’objet SqlParameter spécifié de la collection.Removes the specified SqlParameter from the collection.

RemoveAt(Int32)

Supprime l'objet SqlParameter de l'objet SqlParameterCollection à l'index spécifié.Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String)

Supprime l'objet SqlParameter de l'objet SqlParameterCollection au niveau du nom de paramètre spécifié.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi