IDataParameter.Value IDataParameter.Value IDataParameter.Value IDataParameter.Value Property

Définition

Obtient ou définit la valeur du paramètre.Gets or sets the value of the parameter.

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 qui représente la valeur du paramètre.An Object that is the value of the parameter. La valeur par défaut est null.The default value is 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.The following example creates an instance of the implementing class, SqlParameter, and sets some of its properties.

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 IDbCommand au qui est envoyé au serveur.For input parameters, the value is bound to the IDbCommand that is sent to the server. Pour les paramètres de sortie et de valeur de retour, la valeur est définie IDbCommand à l’achèvement IDataReader de et après la fermeture de.For output and return value parameters, the value is set on completion of the IDbCommand and after the IDataReader is closed.

Lors de l’envoi d’une valeur de paramètre null au serveur, l' DBNullutilisateur doit spécifier, et non null.When sending a null parameter value to the server, the user must specify DBNull, not null. Dans le système, la valeur null désigne un objet vide qui ne possède pas de valeur.The null value in the system is an empty object that has no value. DBNull est utilisé pour représenter des valeurs null.DBNull is used to represent null values.

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.If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. Le fournisseur tente de convertir n’importe quel type de valeur s’il IConvertible prend en charge l’interface.The provider attempts to convert any type of value if it supports the IConvertible interface. Des erreurs de conversion peuvent se produire si le type spécifié n’est pas compatible avec la valeur.Conversion errors may result if the specified type is not compatible with the value.

La Value propriété est remplacée par Update.The Value property is overwritten by Update.

S’applique à