IDataParameter.Value Propriété

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

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

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

public object? Value { get; set; }

member this.Value : obj with get, set

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.

Exemples

L’exemple suivant crée une instance de la classe d’implémentation, SqlParameter, et définit certaines de ses propriétés.

public void CreateSqlParameter()
{
    SqlParameter parameter = new SqlParameter(
        "@Description", SqlDbType.VarChar);
    parameter.Value = "garden hose";
    parameter.Size = 11;
}

Public Sub CreateSqlParameter()
    Dim parameter As New SqlParameter( _
        "@Description", SqlDbType.VarChar)
    parameter.Value = "garden hose"
    parameter.Size = 11
End Sub

Remarques

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

Lors de l’envoi d’une valeur de paramètre Null au serveur, l’utilisateur doit spécifier DBNull, et non null. Dans le système, la valeur null désigne un objet vide qui ne possède pas de valeur. DBNull est utilisé pour représenter des valeurs null.

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.

La Value propriété est remplacée par Update.