Udostępnij za pośrednictwem

SqlParameter.Value Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Zestawy:
netstandard.dll, System.Data.SqlClient.dll
Pakiet:
System.Data.SqlClient v4.8.6

Pobiera lub ustawia wartość parametru.

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

Wartość właściwości

Object

Jest Object to wartość parametru . Wartość domyślna to null.

Implementuje

Value
Atrybuty
TypeConverterAttribute DataSysDescriptionAttribute

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre jego właściwości.

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

Uwagi

W przypadku parametrów wejściowych wartość jest powiązana z wartością SqlCommand , która jest wysyłana do serwera. W przypadku parametrów wyjściowych i zwracanych wartości wartość jest ustawiana po zakończeniu SqlCommand elementu i po SqlDataReader zamknięciu.

Tę właściwość można ustawić na null lub DBNull.Value. Użyj DBNull.Value polecenia , aby wysłać wartość NULL jako wartość parametru. Użyj null lub nie ustaw Value wartości domyślnej dla parametru .

Wyjątek jest zgłaszany, jeśli dane XML inne niż Unicode są przekazywane jako ciąg.

Jeśli aplikacja określa typ bazy danych, powiązana wartość jest konwertowana na ten typ, gdy dostawca wysyła dane na serwer. Dostawca próbuje przekonwertować dowolny typ wartości, jeśli obsługuje IConvertible interfejs. Błędy konwersji mogą spowodować, że określony typ nie jest zgodny z wartością.

DbType Właściwości i SqlDbType można wywnioskować, ustawiając wartość.

Właściwość Value jest zastępowana przez SqlDataAdapter.UpdateCommand.

Aby uzyskać informacje na temat przesyłania strumieniowego, zobacz SqlClient Streaming Support (Obsługa przesyłania strumieniowego sqlClient).

Dotyczy

Zobacz też