IDataParameter.Value Vlastnost

Definice

Získá nebo nastaví hodnotu parametru.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

Hodnota vlastnosti

Object, která je hodnotou parametru.An Object that is the value of the parameter. Výchozí hodnotou je hodnota null.The default value is null.

Příklady

Následující příklad vytvoří instanci implementující třídy, SqlParametera nastaví některé z jejích vlastností.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 

Poznámky

U vstupních parametrů je hodnota vázána na IDbCommand, která je odeslána na server.For input parameters, the value is bound to the IDbCommand that is sent to the server. Pro výstupní a návratové parametry hodnoty se nastaví hodnota po dokončení IDbCommand a po zavření IDataReader.For output and return value parameters, the value is set on completion of the IDbCommand and after the IDataReader is closed.

Při odesílání hodnoty parametru s hodnotou null na server musí uživatel zadat DBNull, nikoli hodnotu null.When sending a null parameter value to the server, the user must specify DBNull, not null. Hodnota null v systému je prázdný objekt, který nemá žádnou hodnotu.The null value in the system is an empty object that has no value. DBNull slouží k reprezentaci hodnot null.DBNull is used to represent null values.

Pokud aplikace určuje typ databáze, bude vázaná hodnota převedena na tento typ, když zprostředkovatel odešle data na server.If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. Zprostředkovatel se pokusí převést jakýkoli typ hodnoty, pokud podporuje rozhraní IConvertible.The provider attempts to convert any type of value if it supports the IConvertible interface. Pokud zadaný typ není kompatibilní s hodnotou, může dojít k chybám převodu.Conversion errors may result if the specified type is not compatible with the value.

Vlastnost Value je přepsána Update.The Value property is overwritten by Update.

Platí pro