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.
Применяется к
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided), 10 (package-provided) |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |