SqlParameter.Value Eigenschaft

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Wert des Parameters ab oder legt diesen fest.

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

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

public override object Value { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }

member this.Value : obj with get, set

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

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

Public Overrides Property Value As Object

Public Property Value As Object

Eigenschaftswert

Object

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

Implementiert

Value

Attribute: TypeConverterAttribute DataSysDescriptionAttribute

Beispiele

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

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

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

Hinweise

Bei Eingabeparametern wird der Wert an das gebunden, das SqlCommand an den Server gesendet wird. Bei Ausgabe- und Rückgabewertparametern wird der Wert nach Abschluss von SqlCommand und festgelegt, nachdem der SqlDataReader geschlossen 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 Oder null nicht festlegen 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 DbType -Eigenschaft als SqlDbType auch die -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:

Freigeben über