IDataParameter.Value-Eigenschaft

Ruft den Wert des Parameters ab oder legt diesen fest.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Property Value As Object
'Usage
Dim instance As IDataParameter
Dim value As Object

value = instance.Value

instance.Value = value

Object Value { get; set; }

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

/** @property */
Object get_Value ()

/** @property */
void set_Value (Object value)

function get Value () : Object

function set Value (value : Object)

Eigenschaftenwert

Eine Object-Klasse, die den Wert des Parameters darstellt. Der Standardwert ist NULL.

Hinweise

Bei Eingabeparametern ist der Wert an die IDbCommand-Schnittstelle gebunden, die an den Server gesendet wird. Bei Ausgabe- und Rückgabewertparametern wird der Wert festgelegt, nachdem die Ausführung der IDbCommand-Schnittstelle abgeschlossen ist und die IDataReader-Schnittstelle geschlossen wurde.

Wenn ein NULL-Parameterwert an den Server gesendet wird, muss der Benutzer DBNull anstelle von NULL angeben. Der NULL-Wert im System ist ein leeres Objekt ohne Wert. Mit DBNull werden NULL-Werte dargestellt.

Wenn die Anwendung den Datenbanktyp angibt, wird der gebundene Wert in diesen Typ konvertiert, wenn der Provider die Daten an den Server sendet. Wenn der Anbieter die IConvertible-Schnittstelle unterstützt, versucht er, sämtliche Typen von Werten zu konvertieren. Falls der angegebene Typ nicht mit dem Wert kompatibel ist, können Konvertierungsfehler auftreten.

Die Value-Eigenschaft wird durch Update überschrieben.

Beispiel

Im folgenden Beispiel wird eine Instanz der implementierenden Klasse SqlParameter erstellt, und einige ihrer Eigenschaften werden festgelegt.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDataParameter-Schnittstelle
IDataParameter-Member
System.Data-Namespace