SqlParameter Constructeurs

Définition

Espace de noms:: System.Data.SqlClient

Assembly:: System.Data.dll

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.

Initialise une nouvelle instance de la classe SqlParameter.

Surcharges

Nom	Description
SqlParameter()	Initialise une nouvelle instance de la classe SqlParameter.
SqlParameter(String, SqlDbType)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre et le type de données.
SqlParameter(String, Object)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre et une valeur du nouveau SqlParameter.
SqlParameter(String, SqlDbType, Int32)	Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre, la SqlDbTypetaille et la taille.
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.
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.
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.

SqlParameter()

Initialise une nouvelle instance de la classe SqlParameter.

public:
 SqlParameter();

public SqlParameter();

Public Sub New ()

Exemples

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter()
    With parameter
        .ParameterName = "@Description"
        .IsNullable = True
        .SqlDbType = SqlDbType.VarChar
        .Direction = ParameterDirection.Output
        .Size = 88
    End With

    command.Parameters.Add(parameter)
End Sub

Voir aussi

S’applique à

SqlParameter(String, SqlDbType)

Initialise une nouvelle instance de la SqlParameter classe 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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> System.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 SqlDbType valeurs.

Exceptions

ArgumentException

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

Exemples

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Size = 88
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Remarques

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

Voir aussi

S’applique à

SqlParameter(String, Object)

Initialise une nouvelle instance de la SqlParameter classe 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 System.Data.SqlClient.SqlParameter : string * obj -> System.Data.SqlClient.SqlParameter

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

Paramètres

parameterName: String

Nom du paramètre à mapper.

value: Object

C’est Object la valeur du SqlParameter.

Exemples

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Remarques

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

Soyez prudent lorsque vous utilisez cette surcharge du SqlParameter constructeur pour spécifier des valeurs de paramètre d’entier. Étant donné que cette surcharge prend un value 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 part du principe que vous essayez d’appeler la surcharge du SqlParameter(String, SqlDbType) constructeur.

Voir aussi

S’applique à

SqlParameter(String, SqlDbType, Int32)

Initialise une nouvelle instance de la SqlParameter classe qui utilise le nom du paramètre, la SqlDbTypetaille 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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.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 SqlDbType valeurs.

size: Int32

Longueur du paramètre.

Exceptions

ArgumentException

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

Exemples

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

Remarques

La taille est déduite de la valeur du dbType paramètre s’il n’est pas défini explicitement dans le size paramètre.

Voir aussi

S’applique à

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.

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.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 SqlDbType valeurs.

size: Int32

Longueur du paramètre.

sourceColumn: String

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

Exceptions

ArgumentException

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

Exemples

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

Remarques

La taille est déduite de la valeur du dbType paramètre s’il n’est pas défini explicitement dans le size paramètre.

Voir aussi

S’applique à

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.

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.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 SqlDbType valeurs.

size: Int32

Longueur du paramètre.

direction: ParameterDirection

Une des ParameterDirection valeurs.

isNullable: Boolean

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

precision: Byte

Nombre total de chiffres à gauche et à droite du point décimal vers lequel Value est résolu.

scale: Byte

Nombre total de décimales à laquelle Value est résolu.

sourceColumn: String

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

sourceVersion: DataRowVersion

Une des DataRowVersion valeurs.

value: Object

C’est Object la valeur du SqlParameter.

Exceptions

ArgumentException

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

Exemples

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 11, ParameterDirection.Input, _
        True, 0, 0, "Description", DataRowVersion.Current, _
        "garden hose")
    parameter.IsNullable = True

    command.Parameters.Add(parameter)
End Sub

Remarques

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

Voir aussi

S’applique à

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.

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.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 SqlDbType valeurs.

size: Int32

Longueur du paramètre.

direction: ParameterDirection

Une des ParameterDirection valeurs.

precision: Byte

Nombre total de chiffres à gauche et à droite du point décimal vers lequel Value est résolu.

scale: Byte

Nombre total de décimales à laquelle Value est résolu.

sourceColumn: String

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

sourceVersion: DataRowVersion

Une des DataRowVersion valeurs.

sourceColumnNullMapping: Boolean

true si la colonne source est nullable ; false si ce n’est pas le cas.

value: Object

C’est Object la valeur du 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 paramètres et Precision sont déduits de la valeur du dbType paramètre s’ils ne sont pas définis explicitement dans les paramètres et precision les size paramètres.

Voir aussi

S’applique à

Commentaires

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