SqlParameter.Value Propriété

Définition

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))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }
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
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
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

Attributs

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 sortie et de valeur de retour, la valeur est définie à l’achèvement de SqlCommand et après la SqlDataReader fermeture de.

Cette propriété peut avoir la valeur null ou DBNull.Value . Utilisez DBNull.Value pour envoyer une valeur null en tant que valeur du paramètre. Utilisez null ou ne définissez pas Value 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 en tant que chaîne.

Si l’application spécifie le type de base de données, la valeur liée est convertie vers 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' IConvertible interface. Des erreurs de conversion peuvent se produire si le type spécifié n’est pas compatible avec la valeur.

Les DbType 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.

S’applique à

Voir aussi