SqlParameter.Value Eigenschaft

Definition

Ruft den Wert des Parameters ab oder legt diesen fest.Gets or sets the value of the parameter.

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.An Object that is the value of the parameter. Der Standardwert ist "null".The default value is null.

Implementiert

Attribute

Beispiele

Im folgenden Beispiel wird ein erstellt, SqlParameter und einige der zugehörigen Eigenschaften werden festgelegt.The following example creates a SqlParameter and sets some of its properties.

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

Für Eingabeparameter wird der Wert an den gebunden, der SqlCommand an den Server gesendet wird.For input parameters, the value is bound to the SqlCommand that is sent to the server. Für Ausgabe-und Rückgabewert Parameter wird der Wert beim Abschluss von SqlCommand und nach dem Schließen des festgelegt SqlDataReader .For output and return value parameters, the value is set on completion of the SqlCommand and after the SqlDataReader is closed.

Diese Eigenschaft kann auf oder festgelegt werden null DBNull.Value .This property can be set to null or DBNull.Value. Verwenden Sie DBNull.Value , um einen NULL-Wert als Wert des-Parameters zu senden.Use DBNull.Value to send a NULL value as the value of the parameter. Verwenden Sie null oder nicht Value , um den Standardwert für den Parameter zu verwenden.Use null or do not set Value to use the default value for the parameter.

Eine-Ausnahme wird ausgelöst, wenn nicht-Unicode-XML-Daten als Zeichenfolge übermittelt werden.An exception is thrown if non-Unicode XML data is passed as a string.

Wenn die Anwendung den Datenbanktyp angibt, wird der gebundene Wert in diesen Typ konvertiert, wenn der Anbieter die Daten an den Server sendet.If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. Der Anbieter versucht, jeden Werttyp zu konvertieren, wenn er die- IConvertible Schnittstelle unterstützt.The provider tries to convert any type of value if it supports the IConvertible interface. Konvertierungs Fehler können auftreten, wenn der angegebene Typ nicht mit dem Wert kompatibel ist.Conversion errors may result if the specified type is not compatible with the value.

Die DbType -Eigenschaft und die-Eigenschaft SqlDbType können durch Festlegen des-Werts abgeleitet werden.Both the DbType and SqlDbType properties can be inferred by setting the Value.

Die- Value Eigenschaft wird von überschrieben SqlDataAdapter.UpdateCommand .The Value property is overwritten by SqlDataAdapter.UpdateCommand.

Weitere Informationen zum Streaming finden Sie unter SqlClient-Streamingunterstützung.For information about streaming, see SqlClient Streaming Support.

Gilt für: