SqlParameter.Value-Eigenschaft

Artikel
08/20/2007

Ruft den Wert des Parameters ab oder legt diesen fest.

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

Syntax

'Declaration
Public Overrides Property Value As Object
'Usage
Dim instance As SqlParameter
Dim value As Object

value = instance.Value

instance.Value = value

public override Object Value { get; set; }

public:
virtual property Object^ Value {
    Object^ get () override;
    void set (Object^ value) override;
}

/** @property */
public Object get_Value ()

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

public override function get Value () : Object

public override function set Value (value : Object)

Eigenschaftenwert

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

Hinweise

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

Wenn Sie einen NULL-Parameterwert an den Server senden, muss der Benutzer nicht NULL, sondern DBNull 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 Anbieter die Daten an den Server sendet. Wenn der Anbieter die IConvertible-Schnittstelle unterstützt, versucht er, sämtliche Werttypen zu konvertieren. Falls der angegebene Typ nicht mit dem Wert kompatibel ist, können Konvertierungsfehler auftreten.

Durch Festlegen des Werts kann sowohl die DbType-Eigenschaft als auch die SqlDbType-Eigenschaft abgeleitet werden.

Die Value-Eigenschaft wird durch M.System.Data.SqlClient.SqlDataAdapter.UpdateCommand überschrieben.

Beispiel

Im folgenden Beispiel wird ein SqlParameter erstellt, und einige seiner Eigenschaften werden festgelegt.

Private Sub CreateSqlParameterVersion()
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar, 88)
    parameter.Value = "garden hose"
End Sub

static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}

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

SqlParameter-Klasse
SqlParameter-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server

Freigeben über