SqlParameter.Value Właściwość

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Pobiera lub ustawia wartość parametru.

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

Wartość właściwości

Object

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

Implementuje

Value

Atrybuty

TypeConverterAttribute

Przykłady

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

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

Uwagi

W przypadku parametrów wejściowych wartość jest powiązana z SqlCommand serwerem, który jest wysyłany do serwera. W przypadku parametrów danych wyjściowych i zwracanych wartości wartość jest ustawiana po zakończeniu SqlCommandSqlDataReader operacji i po zamknięciu.

Tę właściwość można ustawić na null lub DBNull.Value. Użyj polecenia DBNull.Value , 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 do serwera. 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 Obsługa przesyłania strumieniowego SqlClient.