SqlParameter Classe

Définition

Représente un paramètre passé à un SqlCommand et, éventuellement, son mappage à des colonnes DataSet. 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 des paramètres.

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
public ref class SqlParameter sealed : System::Data::Common::DbParameter
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : 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("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
type SqlParameter = class
    inherit DbParameter
    interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface 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
[<System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
[<System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Héritage
SqlParameter
Héritage
Héritage
SqlParameter
Attributs
Implémente

Exemples

L’exemple suivant crée plusieurs instances de SqlParameter par le biais de la SqlParameterCollection collection dans le SqlDataAdapter . Ces paramètres sont utilisés pour sélectionner des données dans la source de données et les placer 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 pour obtenir des exemples supplémentaires sur l’utilisation des paramètres, consultez extraction et modification de données dans ADO.net et Configuration des paramètres et des types de donnéesde paramètres.

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.

Notes

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 des exemples de code supplémentaires illustrant l’utilisation des paramètres, consultez commandes et paramètres.

Constructeurs

SqlParameter()

Initialise une nouvelle instance de la classe SqlParameter.

SqlParameter(String, Object)

Initialise une nouvelle instance de la classe SqlParameter qui utilise le nom du paramètre et une valeur du nouveau SqlParameter.

SqlParameter(String, SqlDbType)

Initialise une nouvelle instance de la classe SqlParameter qui utilise le nom du paramètre et le type de données.

SqlParameter(String, SqlDbType, Int32)

Initialise une nouvelle instance de la classe SqlParameter qui utilise le nom du paramètre, le SqlDbType et la taille.

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Initialise une nouvelle instance de la classe SqlParameter qui utilise le nom du paramètre, le type du paramètre, la taille du paramètre, une ParameterDirection, la précision du paramètre, l’échelle du paramètre, la colonne source, une DataRowVersion à utiliser et la valeur du paramètre.

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Initialise une nouvelle instance de la classe SqlParameter 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 valeurs de DataRowVersion, une valeur booléenne pour le mappage des colonnes sources, la valeur de SqlParameter, le nom de la base de données dans laquelle se trouve la collection de schémas pour cette instance XML, le schéma relationnel propriétaire dans lequel se trouve la collection de schémas pour cette instance XML et le nom de la collection de schémas pour ce paramètre.

SqlParameter(String, SqlDbType, Int32, String)

Initialise une nouvelle instance de la classe SqlParameter qui utilise le nom du paramètre, le SqlDbType, la taille et le nom de la colonne source.

Propriétés

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.

DbType

Obtient ou définit le SqlDbType du paramètre.

Direction

Obtient ou définit une valeur qui indique si le paramètre est un paramètre d'entrée uniquement, de sortie uniquement, bidirectionnel ou de valeur de retour d'une procédure stockée.

ForceColumnEncryption

Applique le chiffrement d’un paramètre lors de l’utilisation de la fonctionnalité Always Encrypted. Si SQL Server informe le pilote que le paramètre ne nécessite pas de chiffrement, la requête utilisant le paramètre échoue. Cette propriété fournit une protection supplémentaire contre les attaques au niveau de la sécurité qui impliquent un serveur SQL Server compromis fournissant des métadonnées de chiffrement incorrectes au client, ce qui peut entraîner la divulgation de données.

IsNullable

Obtient ou définit une valeur qui indique si le paramètre accepte les valeurs Null. IsNullable n’est pas utilisé pour valider la valeur du paramètre et n’empêche pas l’envoi ni la réception d’une valeur null durant l’exécution d’une commande.

LocaleId

Obtient ou définit l’identificateur de paramètres régionaux qui détermine les conventions et la langue pour une région particulière.

Offset

Obtient ou définit l’offset sur la propriété Value.

ParameterName

Obtient ou définit le nom de l'objet SqlParameter.

Precision

Obtient ou définit le nombre maximal de chiffres utilisés pour représenter la propriété Value.

Scale

Obtient ou définit le nombre de décimales appliqué à la résolution de Value.

Size

Obtient ou définit la taille maximale, en octets, des données dans la colonne.

SourceColumn

Obtient ou définit le nom de la colonne source mappée à DataSet et utilisée pour charger et retourner Value.

SourceColumnNullMapping

Obtient ou définit une valeur qui indique si la colonne source accepte la valeur Null. Ainsi, SqlCommandBuilder peut générer correctement des instructions Update pour les colonnes qui acceptent la valeur Null.

SourceVersion

Obtient ou définit le DataRowVersion à utiliser lors du chargement de Value.

SourceVersion

Obtient ou définit le DataRowVersion à utiliser lors du chargement de Value.

(Hérité de DbParameter)
SqlDbType

Obtient ou définit le SqlDbType du paramètre.

SqlValue

Obtient ou définit la valeur du paramètre sous forme de type SQL.

TypeName

Obtient ou définit le nom de type d’un paramètre table.

UdtTypeName

Obtient ou définit une string qui représente un type défini par l’utilisateur en tant que paramètre.

Value

Obtient ou définit la valeur du paramètre.

XmlSchemaCollectionDatabase

Obtient le nom de la base de données où se trouve la collection de schémas pour cette instance XML.

XmlSchemaCollectionName

Obtient le nom de la collection de schémas pour cette instance XML.

XmlSchemaCollectionOwningSchema

Schéma relationnel propriétaire où se trouve la collection de schémas pour cette instance XML.

Méthodes

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.

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

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office 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 en cours qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetType()

Obtient le 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 Object actuel.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
ResetDbType()

Rétablit le type associé à cet objet SqlParameter.

ResetSqlDbType()

Rétablit le type associé à cet objet SqlParameter.

ToString()

Obtient une chaîne qui contient l'objet ParameterName.

Implémentations d’interfaces explicites

ICloneable.Clone()

Pour obtenir une description de ce membre, consultez Clone().

IDataParameter.SourceVersion

Récupère ou définit le DataRowVersion à utiliser au chargement de 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