SqlParameter.Value Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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; }

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set

Public Overrides Property Value As Object

Eigenschaftswert

Object

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

Implementiert

Value

Attribute

TypeConverterAttribute

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.