SqlParameter.Value Propriété

  • Référence

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paquet:
System.Data.SqlClient v4.8.6

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

public:
 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public override object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
[<System.Data.DataSysDescription("DataParameter_Value")>]
member this.Value : obj with get, set
Public Overrides Property Value As Object
Public 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 DataSysDescriptionAttribute

Exemples

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

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

Private Sub CreateSqlParameterVersion()
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar, 88)
    parameter.Value = "garden hose"
End Sub

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 SqlCommand du et après la fermeture de 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 pour le 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 de SqlClient Streaming.

S’applique à

Voir aussi