SqlParameter.SqlValue Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Dient zum Abrufen oder Festlegen des Werts des Parameters als SQL-Typ.

public:
 property System::Object ^ SqlValue { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Browsable(false)]
public object SqlValue { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SqlValue : obj with get, set

Public Property SqlValue As Object

Eigenschaftswert

Object

Ein Object, das der Wert des Parameters unter Verwendung von SQL-Typen ist. Der Standardwert ist "null".

Attribute

BrowsableAttribute

Hinweise

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

Diese Eigenschaft kann auf NULL oder DBNull.Valuefestgelegt werden. Verwenden Sie DBNull.Value , um einen NULL-Wert als Wert des Parameters zu senden. Verwenden Sie NULL, oder legen Sie nicht fest SqlParameter.SqlValue , um den Standardwert für den Parameter zu verwenden.

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.

Sowohl die DbType Eigenschaften als SqlDbType auch können durch Festlegen von SqlParameter.Valueabgeleitet werden.

Die SqlParameter.Value -Eigenschaft wird von überschrieben SqlDataAdapter.UpdateCommand.

Verwenden Sie die SqlParameter.Value -Eigenschaft, um Parameterwerte als CLR-Typen (Common Language Runtime) zurückzugeben.

Informationen zum Streaming finden Sie unter SqlClient-Streamingunterstützung.