IDataParameter.Value Eigenschaft

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Ruft den Wert des Parameters ab oder legt diesen fest.

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

Eigenschaftswert

Object

Ein Object, das den Wert des Parameters darstellt. Der Standardwert ist "null".

Beispiele

Im folgenden Beispiel wird eine instance der implementierenden Klasse erstellt und SqlParametereinige ihrer Eigenschaften festgelegt.

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

Hinweise

Bei Eingabeparametern wird der Wert an die gebunden, die IDbCommand an den Server gesendet wird. Bei Ausgabe- und Rückgabewertparametern wird der Wert nach Abschluss von IDbCommand und festgelegt, nachdem geschlossen IDataReader wurde.

Beim Senden eines NULL-Parameterwerts an den Server muss der Benutzer angeben DBNull, nicht NULL. Der NULL-Wert im System ist ein leeres Objekt, das über keinen Wert verfügt. DBNull wird zur Darstellung von NULL-Werten verwendet.

Wenn die Anwendung den Datenbanktyp angibt, wird der gebundene Wert in diesen Typ konvertiert, wenn der Anbieter die Daten an den Server sendet. Der Anbieter versucht, einen beliebigen Werttyp zu konvertieren, wenn er die IConvertible -Schnittstelle unterstützt. Konvertierungsfehler können auftreten, wenn der angegebene Typ nicht mit dem Wert kompatibel ist.

Die Value -Eigenschaft wird von überschrieben Update.