SqlParameter Classe

Définition

Espace de noms:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Source:: System.Data.SqlClient.notsupported.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un paramètre à un SqlCommand et éventuellement son mappage aux DataSet colonnes. Cette classe ne peut pas être héritée. Pour plus d’informations sur les paramètres, consultez Configuration des paramètres et des types de données de paramètres.

Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.

public ref class SqlParameter sealed : System::Data::Common::DbParameter

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Héritage: Object

DbParameter
SqlParameter

Héritage: Object

MarshalByRefObject

DbParameter
SqlParameter

Héritage: Object

MarshalByRefObject
SqlParameter

Attributs: TypeConverterAttribute

Implémente: IDataParameter IDbDataParameter ICloneable

Exemples

L’exemple suivant crée plusieurs instances de SqlParameter la SqlParameterCollection collection au sein de la SqlDataAdaptercollection. Ces paramètres sont utilisés pour sélectionner des données à partir de la source de données et placer les données dans le DataSet. Cet exemple suppose qu’un DataSet et un SqlDataAdapter ont déjà été créés à l’aide du schéma, des commandes et de la connexion appropriés. Pour plus d’informations et des exemples supplémentaires sur l’utilisation de paramètres, consultez Retrieving et modification de données dans ADO.NET et Configuring Parameters and Parameter Data Types.

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

Les noms de paramètres ne respectent pas la casse.

Note

Sans nom, également appelé ordinal, les paramètres ne sont pas pris en charge par le fournisseur de données .NET Framework pour SQL Server.

Pour plus d’informations, ainsi que d’autres exemples de code illustrant comment utiliser des paramètres, consultez Commandes et paramètres.

Constructeurs

Nom	Description
SqlParameter()	Initialise une nouvelle instance de la classe SqlParameter. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlParameter(String, Object)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre et une valeur du nouveau SqlParameter. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre, le type du paramètre, la taille du paramètre, une ParameterDirectionprécision du paramètre, l’échelle du paramètre, l’échelle du paramètre, la colonne source, a DataRowVersion à utiliser et la valeur du paramètre. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre, le type du paramètre, la longueur du paramètre, la direction, la précision, l’échelle, le nom de la colonne source, l’une des DataRowVersion valeurs, une valeur booléenne pour le mappage de colonne source, la valeur du `SqlParameter`, le nom de la base de données où se trouve la collection de schémas pour cette instance XML, le schéma relationnel propriétaire où se trouve la collection de schémas pour cette instance XML et le nom de la collection de schémas pour ce paramètre. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, String)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre, la taille SqlDbTypeet le nom de colonne source. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre, la SqlDbTypetaille et la taille. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlParameter(String, SqlDbType)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre et le type de données. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.

Propriétés

Nom	Description
CompareInfo	Obtient ou définit l’objet CompareInfo qui définit la façon dont les comparaisons de chaînes doivent être effectuées pour ce paramètre. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
DbType	Obtient ou définit le SqlDbType paramètre. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
Direction	Obtient ou définit une valeur qui indique si le paramètre est un paramètre de valeur de retour d’entrée uniquement, de sortie uniquement, bidirectionnel ou de procédure stockée. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
ForceColumnEncryption	Applique le chiffrement d’un paramètre lors de l’utilisation d’Always Encrypted. Si SQL Server informe le pilote que le paramètre n’a pas besoin d’être chiffré, la requête utilisant le paramètre échoue. Cette propriété offre une protection supplémentaire contre les attaques de sécurité qui impliquent une SQL Server compromise fournissant des métadonnées de chiffrement incorrectes au client, ce qui peut entraîner la divulgation de données. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
IsNullable	Obtient ou définit une valeur qui indique si le paramètre accepte des valeurs Null. IsNullable n’est pas utilisé pour valider la valeur du paramètre et n’empêche pas l’envoi ou la réception d’une valeur Null lors de l’exécution d’une commande. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
LocaleId	Obtient ou définit l’identificateur de paramètres régionaux qui détermine les conventions et la langue d’une région particulière. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
Offset	Obtient ou définit le décalage sur la Value propriété. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
ParameterName	Obtient ou définit le nom du SqlParameter. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
Precision	Obtient ou définit le nombre maximal de chiffres utilisés pour représenter la Value propriété. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
Scale	Obtient ou définit le nombre de décimales à laquelle Value est résolu. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
Size	Obtient ou définit la taille maximale, en octets, des données de la colonne. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SourceColumn	Obtient ou définit le nom de la colonne source mappée au DataSet chargement ou au renvoi de la Valuecolonne source. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SourceColumnNullMapping	Obtient ou définit une valeur qui indique si la colonne source est nullable. Cela permet SqlCommandBuilder de générer correctement des instructions Update pour les colonnes nullables. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SourceVersion	Obtient ou définit la DataRowVersion valeur à utiliser lorsque vous chargez Value. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlDbType	Obtient ou définit le SqlDbType paramètre. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
SqlValue	Obtient ou définit la valeur du paramètre en tant que type SQL. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
TypeName	Obtient ou définit le nom de type d’un paramètre table. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
UdtTypeName	Obtient ou définit un `string` type défini par l’utilisateur en tant que paramètre. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
Value	Obtient ou définit la valeur du paramètre. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
XmlSchemaCollectionDatabase	Obtient le nom de la base de données où se trouve la collection de schémas pour cette instance XML. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
XmlSchemaCollectionName	Obtient le nom de la collection de schémas pour cette instance XML. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
XmlSchemaCollectionOwningSchema	Schéma relationnel propriétaire où se trouve la collection de schémas pour cette instance XML. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.

Méthodes

Nom	Description
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)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. 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)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. 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)
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)
ResetDbType()	Réinitialise le type associé à ce SqlParameter. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
ResetSqlDbType()	Réinitialise le type associé à ce SqlParameter. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
ToString()	Obtient une chaîne qui contient le ParameterName. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.

Implémentations d’interfaces explicites

Nom	Description
ICloneable.Clone()	Pour obtenir une description de ce membre, consultez Clone(). Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
IDataParameter.SourceVersion	Obtient ou définit la valeur à utiliser lors du DataRowVersion chargement Value. (Hérité de DbParameter)
IDbDataParameter.Precision	Indique la précision des paramètres numériques. (Hérité de DbParameter)
IDbDataParameter.Scale	Pour obtenir une description de ce membre, consultez Scale. (Hérité de DbParameter)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?