SqlParameter.Value Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

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

public:
 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set

Public Overrides Property Value As Object

Valeur de propriété

Object

Object qui représente la valeur du paramètre. La valeur par défaut est null.

Implémente

Value

Attributs

TypeConverterAttribute

Exemples

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

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}

Remarques

Pour les paramètres d’entrée, la valeur est liée au SqlCommand qui est envoyé au serveur. Pour les paramètres de valeur de sortie et de retour, la valeur est définie à l’achèvement de et SqlCommand après la fermeture du SqlDataReader .

Cette propriété peut être définie sur null ou DBNull.Value. Utilisez DBNull.Value pour envoyer une valeur NULL comme valeur du paramètre. Utilisez null ou ne définissez Value pas pour utiliser la valeur par défaut du paramètre.

Une exception est levée si des données XML non Unicode sont passées sous forme de chaîne.

Si l’application spécifie le type de base de données, la valeur liée est convertie en ce type lorsque le fournisseur envoie les données au serveur. Le fournisseur tente de convertir n’importe quel type de valeur s’il prend en charge l’interface IConvertible . Des erreurs de conversion peuvent se produire si le type spécifié n’est pas compatible avec la valeur.

DbType Les propriétés et SqlDbType peuvent être déduites en définissant la valeur.

La Value propriété est remplacée par SqlDataAdapter.UpdateCommand.

Pour plus d’informations sur la diffusion en continu, consultez Prise en charge du streaming SqlClient.