SqlParameter Constructeurs

Référence

Définition

Espace de noms:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Paquet:: Microsoft.Data.SqlClient v1.0.19269.1

Paquet:: Microsoft.Data.SqlClient v1.1.4

Paquet:: Microsoft.Data.SqlClient v2.0.1

Paquet:: Microsoft.Data.SqlClient v2.1.4

Paquet:: Microsoft.Data.SqlClient v3.0.1

Paquet:: Microsoft.Data.SqlClient v3.1.0

Paquet:: Microsoft.Data.SqlClient v4.0.1

Paquet:: Microsoft.Data.SqlClient v4.1.0

Paquet:: Microsoft.Data.SqlClient v5.0.0

Paquet:: Microsoft.Data.SqlClient v5.1.0

Paquet:: Microsoft.Data.SqlClient v5.2.0

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.

Surcharges

SqlParameter()	Initialise une nouvelle instance de la classe 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, 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, 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, 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.
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()

Initialise une nouvelle instance de la classe SqlParameter.

public:
 SqlParameter();

public SqlParameter ();

Public Sub New ()

Exemples

L’exemple suivant crée un SqlParameter et définit certaines de ses propriétés.

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter();
        parameter.ParameterName = "@Description";
        parameter.IsNullable = true;
        parameter.SqlDbType = SqlDbType.VarChar;
        parameter.Direction = ParameterDirection.Output;
        parameter.Size = 88;

        command.Parameters.Add(parameter);
    }
}

S’applique à

SqlClient .NET Core 5.2 et autres versions

Produit	Versions
SqlClient .NET Core	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Framework	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Standard	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2

SqlParameter(String, SqlDbType)

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

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType)

Paramètres

parameterName: String

Nom du paramètre à mapper.

dbType: SqlDbType

Une des valeurs de l'objet SqlDbType.

Exceptions

ArgumentException

La valeur fournie dans le paramètre dbType est un type de données principales non valide.

Exemples

L’exemple suivant crée un SqlParameter et définit certaines de ses propriétés.

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command, string paramValue)
    {
        SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;
        parameter.Size = 88;
        parameter.Value = paramValue;

        command.Parameters.Add(parameter);
    }
}

Remarques

Le type de données et, le cas échéant, Size et Precision sont déduits de la valeur du dbType paramètre .

S’applique à

SqlClient .NET Core 5.2 et autres versions

Produit	Versions
SqlClient .NET Core	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Framework	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Standard	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2

SqlParameter(String, Object)

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

public:
 SqlParameter(System::String ^ parameterName, System::Object ^ value);

public SqlParameter (string parameterName, object value);

new Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, value As Object)

Paramètres

parameterName: String

Nom du paramètre à mapper.

value: Object

Object correspondant à la valeur de l'objet SqlParameter.

Exemples

L’exemple suivant crée un SqlParameter et définit certaines de ses propriétés.

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88, "Description");
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;

        command.Parameters.Add(parameter);
    }
}

Remarques

Lorsque vous spécifiez un Object dans le value paramètre , est SqlDbType déduit du type Microsoft .NET Framework du Object.

Soyez prudent lorsque vous utilisez cette surcharge du constructeur pour spécifier des SqlParameter valeurs de paramètre entières. Dans la mesure où cette surcharge accepte un value de type Object, vous devez convertir la valeur intégrale en type Object lorsque la valeur est égale à zéro, comme l'illustre l'exemple C# suivant.

Parameter = new SqlParameter("@pname", (object)0);

Si vous n’effectuez pas cette conversion, le compilateur suppose que vous essayez d’appeler la surcharge du SqlParameter(String, SqlDbType) constructeur.

S’applique à

SqlClient .NET Core 5.2 et autres versions

Produit	Versions
SqlClient .NET Core	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Framework	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Standard	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2

SqlParameter(String, SqlDbType, Int32)

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

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

Paramètres

parameterName: String

Nom du paramètre à mapper.

dbType: SqlDbType

Une des valeurs de l'objet SqlDbType.

size: Int32

Longueur du paramètre.

Exceptions

ArgumentException

La valeur fournie dans le paramètre dbType est un type de données principales non valide.

Exemples

L’exemple suivant crée un SqlParameter et définit certaines de ses propriétés.

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command,
        string paramValue)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88);
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;
        parameter.Value = paramValue;

        command.Parameters.Add(parameter);
    }
}

Remarques

La taille est déduite de la valeur du dbType paramètre si elle n’est pas explicitement définie dans le size paramètre .

S’applique à

SqlClient .NET Core 5.2 et autres versions

Produit	Versions
SqlClient .NET Core	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Framework	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Standard	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2

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.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)

Paramètres

parameterName: String

Nom du paramètre à mapper.

dbType: SqlDbType

Une des valeurs de l'objet SqlDbType.

size: Int32

Longueur du paramètre.

sourceColumn: String

Nom de la colonne source (SourceColumn) s’il SqlParameter est utilisé dans un appel à Update(DataSet)>.

Exceptions

ArgumentException

La valeur fournie dans le paramètre dbType est un type de données principales non valide.

Exemples

L’exemple suivant crée un SqlParameter et définit certaines de ses propriétés.

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88, "Description");
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;

        command.Parameters.Add(parameter);
    }
}

Remarques

La taille est déduite de la valeur du dbType paramètre si elle n’est pas explicitement définie dans le size paramètre .

S’applique à

SqlClient .NET Core 5.2 et autres versions

Produit	Versions
SqlClient .NET Core	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Framework	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Standard	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2

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.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)

Paramètres

parameterName: String

Nom du paramètre à mapper.

dbType: SqlDbType

Une des valeurs de l'objet SqlDbType.

size: Int32

Longueur du paramètre.

direction: ParameterDirection

Une des valeurs de l'objet ParameterDirection.

isNullable: Boolean

true si la valeur du champ peut être null ; sinon, false.

precision: Byte

Nombre total de chiffres à gauche et à droite de la virgule décimale appliqué à la résolution de Value.

scale: Byte

Nombre total de décimales appliqué à la résolution de Value.

sourceColumn: String

Nom de la colonne source (SourceColumn) si ce SqlParameter est utilisé dans un appel à Update(DataSet).

sourceVersion: DataRowVersion

Une des valeurs de l'objet DataRowVersion.

value: Object

Object correspondant à la valeur de l'objet SqlParameter.

Exceptions

ArgumentException

La valeur fournie dans le paramètre dbType est un type de données principales non valide.

Exemples

L’exemple suivant crée un SqlParameter et définit certaines de ses propriétés.

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 11, ParameterDirection.Input,
            true, 0, 0, "Description", DataRowVersion.Current,
            "garden hose");
        parameter.IsNullable = true;

        command.Parameters.Add(parameter);
    }
}

Remarques

Les valeurs Size et Precision sont déduites de la valeur du dbType paramètre s’ils ne sont pas explicitement définis dans les size paramètres et precision .

S’applique à

SqlClient .NET Core 5.2 et autres versions

Produit	Versions
SqlClient .NET Core	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Framework	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Standard	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2

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.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)

Paramètres

parameterName: String

Nom du paramètre à mapper.

dbType: SqlDbType

Une des valeurs de l'objet SqlDbType.

size: Int32

Longueur du paramètre.

direction: ParameterDirection

Une des valeurs de l'objet ParameterDirection.

precision: Byte

Nombre total de chiffres à gauche et à droite de la virgule décimale appliqué à la résolution de Value.

scale: Byte

Nombre total de décimales appliqué à la résolution de Value.

sourceColumn: String

Nom de la colonne source (SourceColumn) s’il SqlParameter est utilisé dans un appel à Update(DataSet)>.

sourceVersion: DataRowVersion

Une des valeurs de l'objet DataRowVersion.

sourceColumnNullMapping: Boolean

true si la colonne source accepte la valeur Null ; false si ce n’est pas le cas.

value: Object

Object correspondant à la valeur de l'objet SqlParameter.

xmlSchemaCollectionDatabase: String

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

xmlSchemaCollectionOwningSchema: String

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

xmlSchemaCollectionName: String

Nom de la collection de schémas pour ce paramètre.

Remarques

Les Size et Precision sont déduits de la valeur du dbType paramètre s’ils ne sont pas explicitement définis dans les size paramètres et precision .

S’applique à

SqlClient .NET Core 5.2 et autres versions

Produit	Versions
SqlClient .NET Core	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Framework	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2
SqlClient .NET Standard	1.0, 1.1, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.0, 5.1, 5.2

Partager via

SqlParameter Constructeurs

Définition

Surcharges

SqlParameter()

Exemples

S’applique à

SqlParameter(String, SqlDbType)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

SqlParameter(String, Object)

Paramètres

Exemples

Remarques

S’applique à

SqlParameter(String, SqlDbType, Int32)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

SqlParameter(String, SqlDbType, Int32, String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

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

Paramètres

Exceptions

Exemples

Remarques

S’applique à

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

Paramètres

Remarques

S’applique à

Ressources supplémentaires