IDataParameter.Value Właściwość

Definicja

Pobiera lub ustawia wartość 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; }
public object Value { get; set; }
member this.Value : obj with get, set
Public Property Value As Object

Wartość właściwości

Object

ObjectJest to wartość parametru.An Object that is the value of the parameter. Wartość domyślna to null.The default value is null.

Przykłady

Poniższy przykład tworzy wystąpienie klasy implementującej, SqlParameter i ustawia niektóre jej właściwości.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 

Uwagi

W przypadku parametrów wejściowych wartość jest powiązana z IDbCommand , która jest wysyłana do serwera.For input parameters, the value is bound to the IDbCommand that is sent to the server. W przypadku parametrów danych wyjściowych i zwracanych wartość jest ustawiana po zakończeniu IDbCommand i po IDataReader zamknięciu.For output and return value parameters, the value is set on completion of the IDbCommand and after the IDataReader is closed.

Podczas wysyłania wartości parametru o wartości null do serwera, użytkownik musi określić DBNull , a nie wartość null.When sending a null parameter value to the server, the user must specify DBNull, not null. Wartość null w systemie jest pustym obiektem, który nie ma wartości.The null value in the system is an empty object that has no value. DBNull służy do reprezentowania wartości null.DBNull is used to represent null values.

Jeśli aplikacja określa typ bazy danych, wartość związana jest konwertowana na ten typ, gdy dostawca wysyła dane do serwera.If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. Dostawca próbuje skonwertować dowolny typ wartości, jeśli obsługuje IConvertible interfejs.The provider attempts to convert any type of value if it supports the IConvertible interface. Błędy konwersji mogą wynikać, jeśli określony typ nie jest zgodny z wartością.Conversion errors may result if the specified type is not compatible with the value.

ValueWłaściwość jest zastępowana przez Update .The Value property is overwritten by Update.

Dotyczy