Freigeben über


SqlParameter.Value Eigenschaft

Definition

Dient zum Abrufen oder Festlegen des Werts des Parameters.

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

Ein Object Wert des Parameters. Der Standardwert ist null.

Implementiert

Attribute

Beispiele

Im folgenden Beispiel wird ein SqlParameter Teil seiner Eigenschaften erstellt und 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 ist der Wert an den SqlCommand Server gebunden. Bei Ausgabe- und Rückgabewertparametern wird der Wert nach Abschluss des SqlCommand Und nach SqlDataReader dem Schließen festgelegt.

Diese Eigenschaft kann auf null oder DBNull.Value. Wird DBNull.Value verwendet, um einen NULL-Wert als Wert des Parameters zu senden. Verwenden null oder 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 dazu führen, dass der angegebene Typ nicht mit dem Wert kompatibel ist.

Sowohl die Eigenschaften SqlDbType als auch die DbType Eigenschaften können durch Festlegen des Werts abgeleitet werden.

Die Value Eigenschaft wird von überschrieben.SqlDataAdapter.UpdateCommand

Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

Gilt für:

Weitere Informationen