SqlParameter.Value Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает значение параметра.

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

Значение свойства

Object

Объект Object, который является значением параметра. По умолчанию используется значение NULL.

Реализации

Value

Атрибуты

TypeConverterAttribute

Примеры

В следующем примере создается SqlParameter и задаются некоторые его свойства.

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

Комментарии

Для входных параметров значение привязывается к объекту SqlCommand , который отправляется на сервер. Для выходных и возвращаемых параметров значения значение задается при завершении SqlCommand и после SqlDataReader закрытия .

Этому свойству можно задать значение null или DBNull.Value. Используйте DBNull.Value для отправки значения NULL в качестве значения параметра . Используйте null или не задается Value , чтобы использовать значение по умолчанию для параметра .

Исключение возникает, если XML-данные, не относящиеся к Юникоду, передаются в виде строки.

Если приложение указывает тип базы данных, привязанное значение преобразуется в этот тип, когда поставщик отправляет данные на сервер. Поставщик пытается преобразовать значение любого типа, если он поддерживает IConvertible интерфейс . Ошибки преобразования могут возникнуть, если указанный тип несовместим со значением.

DbType Свойства и SqlDbType можно вывести, задав значение .

Свойство Value перезаписывается .SqlDataAdapter.UpdateCommand

Сведения о потоковой передаче см. в разделе Поддержка потоковой передачи SqlClient.