SqlParameterCollection.Add Méthode

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

Add(SqlParameter)	Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.
Add(Object)	Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.
Add(String, SqlDbType)	Ajoute un objet SqlParameter à SqlParameterCollection en fonction du nom du paramètre et du type de données.
Add(String, Object)	Obsolète. Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.
Add(String, SqlDbType, Int32)	Ajoute un SqlParameter à SqlParameterCollection, en fonction du nom de paramètre, du SqlDbType et de la taille spécifiés.
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.

Add(SqlParameter)

Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(Microsoft::Data::SqlClient::SqlParameter ^ value);

public Microsoft.Data.SqlClient.SqlParameter Add (Microsoft.Data.SqlClient.SqlParameter value);

override this.Add : Microsoft.Data.SqlClient.SqlParameter -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (value As SqlParameter) As SqlParameter

Paramètres

value: SqlParameter

Objet SqlParameter à ajouter à la collection.

Retours

SqlParameter

Nouvel objet SqlParameter.

Exceptions

ArgumentException

Le SqlParameter spécifié dans le paramètre value est déjà ajouté à celui-ci ou à un autre SqlParameterCollection.

InvalidCastException

Le paramètre passé n'était pas un SqlParameter.

ArgumentNullException

Le paramètre value est null.

Exemples

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        command.Parameters.Add(new SqlParameter("Description", "Beverages"));
    }
}

S’applique à

Add(Object)

Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.

public:
 override int Add(System::Object ^ value);

public override int Add (object value);

override this.Add : obj -> int

Public Overrides Function Add (value As Object) As Integer

Paramètres

value: Object

Élément Object.

Retours

Int32

Index du nouvel objet SqlParameter.

S’applique à

Add(String, SqlDbType)

Ajoute un objet SqlParameter à SqlParameterCollection en fonction du nom du paramètre et du type de données.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);

override this.Add : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameter

Paramètres

parameterName: String

Le nom du paramètre.

sqlDbType: SqlDbType

Une des valeurs de l'objet SqlDbType.

Retours

SqlParameter

Nouvel objet SqlParameter.

Exemples

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = command.Parameters.Add(
            "@Description", SqlDbType.NVarChar);
        param.Size = 16;
        param.Value = "Beverages";
    }
}

S’applique à

Add(String, Object)

Attention

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202

Ajoute l'objet SqlParameter spécifié au SqlParameterCollection.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Object ^ value);

[System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)]
public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, object value);

[<System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)>]
override this.Add : string * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, value As Object) As SqlParameter

Paramètres

parameterName: String

Nom de SqlParameter à ajouter à la collection.

value: Object

Object

Retours

SqlParameter

Nouvel objet SqlParameter.

Faites preuve de prudence lorsque vous utilisez cette surcharge de la méthode SqlParameterCollection.Add pour spécifier des valeurs de paramètre de type Entier. 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.

parameters.Add("@pname", Convert.ToInt32(0));

Si vous n'effectuez pas cette conversion, le compilateur suppose que vous essayez d'appeler la surcharge de SqlParameterCollection.Add (string, SqlDbType).

Attributs: ObsoleteAttribute

Exceptions

ArgumentException

Le SqlParameter spécifié dans le paramètre value est déjà ajouté à celui-ci ou à un autre SqlParameterCollection.

ArgumentNullException

Le paramètre value est null.

Exemples

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = new SqlParameter(
            "@Description", SqlDbType.NVarChar, 16);
        param.Value = "Beverages";
        command.Parameters.Add(param);
    }
}

S’applique à

Add(String, SqlDbType, Int32)

Ajoute un SqlParameter à SqlParameterCollection, en fonction du nom de paramètre, du SqlDbType et de la taille spécifiés.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);

override this.Add : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameter

Paramètres

parameterName: String

Le nom du paramètre.

sqlDbType: SqlDbType

SqlDbType du SqlParameter à ajouter à la collection.

size: Int32

Taille sous forme de Int32.

Retours

SqlParameter

Nouvel objet SqlParameter.

Exemples

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = new SqlParameter(
            "@Description", SqlDbType.NVarChar, 16);
        param.Value = "Beverages";
        command.Parameters.Add(param);
    }
}

Remarques

Cette surcharge est utile lorsque vous ajoutez un paramètre d’un type de données de longueur variable, tel que varchar ou binary.

S’applique à

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.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);

override this.Add : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameter

Paramètres

parameterName: String

Le nom du paramètre.

sqlDbType: SqlDbType

Une des valeurs de l'objet SqlDbType.

size: Int32

Longueur de la colonne.

sourceColumn: String

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

Retours

SqlParameter

Nouvel objet SqlParameter.

Exemples

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand cmd)
    {
        SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
    }
}

S’applique à

Partager via

SqlParameterCollection.Add Méthode

Définition

Surcharges

Add(SqlParameter)

Paramètres

Retours

Exceptions

Exemples

S’applique à

Add(Object)

Paramètres

Retours

S’applique à

Add(String, SqlDbType)

Paramètres

Retours

Exemples

S’applique à

Add(String, Object)

Paramètres

Retours

Exceptions

Exemples

S’applique à

Add(String, SqlDbType, Int32)

Paramètres

Retours

Exemples

Remarques

S’applique à

Add(String, SqlDbType, Int32, String)

Paramètres

Retours

Exemples

S’applique à

Ressources supplémentaires