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 使用 参数的默认值。

如果将非 Unicode XML 数据作为字符串传递，则会引发异常。

如果应用程序指定数据库类型，则当提供程序将数据发送到服务器时，绑定值将转换为该类型。 如果提供程序支持 接口， IConvertible 则尝试转换任何类型的值。 如果指定的类型与值不兼容，则可能会导致转换错误。

DbType可以通过设置 Value 来推断 和 SqlDbType 属性。

属性 Value 被 SqlDataAdapter.UpdateCommand覆盖。

有关流式处理的信息，请参阅 SqlClient 流式处理支持。