SqlParameter.Value Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение параметра.
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
Значение свойства
Объект Object, который является значением параметра. По умолчанию используется значение NULL.
Реализации
- Атрибуты
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
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
Комментарии
Для входных параметров значение привязывается к объекту SqlCommand , который отправляется на сервер. Для выходных и возвращаемых параметров значения значение задается при завершении SqlCommand и после SqlDataReader закрытия .
Этому свойству можно задать значение null
или DBNull.Value. Используйте DBNull.Value для отправки значения NULL в качестве значения параметра . Используйте null
или не задается Value , чтобы использовать значение по умолчанию для параметра .
Исключение возникает, если XML-данные, не относящиеся к Юникоду, передаются в виде строки.
Если приложение указывает тип базы данных, привязанное значение преобразуется в этот тип, когда поставщик отправляет данные на сервер. Поставщик пытается преобразовать значение любого типа, если он поддерживает IConvertible интерфейс . Ошибки преобразования могут возникнуть, если указанный тип несовместим со значением.
DbType Свойства и SqlDbType можно вывести, задав значение .
Свойство Value перезаписывается .SqlDataAdapter.UpdateCommand
Сведения о потоковой передаче см. в разделе Поддержка потоковой передачи SqlClient.