Freigeben über


SqlParameter.Value Eigenschaft

Definition

Ruft den Wert des Parameters ab oder legt diesen fest.

public:
 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }
public override object Value { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set
member this.Value : obj with get, set
Public Overrides Property Value As Object

Eigenschaftswert

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

Implementiert

Attribute

Beispiele

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

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

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 oder legen Sie null nicht fest Value , um den Standardwert für den Parameter zu verwenden.

Eine Ausnahme wird ausgelöst, wenn NICHT-Unicode-XML-Daten als Zeichenfolge übergeben werden.

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 -Eigenschaft als SqlDbType auch die DbType -Eigenschaft können durch Festlegen des Werts abgeleitet werden.

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

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

Gilt für: