SqlParameter 构造函数

参考

定义

命名空间:: Microsoft.Data.SqlClient

程序集:: Microsoft.Data.SqlClient.dll

包:: Microsoft.Data.SqlClient v1.0.19269.1

包:: Microsoft.Data.SqlClient v1.1.4

包:: Microsoft.Data.SqlClient v2.0.1

包:: Microsoft.Data.SqlClient v2.1.4

包:: Microsoft.Data.SqlClient v3.0.1

包:: Microsoft.Data.SqlClient v3.1.0

包:: Microsoft.Data.SqlClient v4.0.1

包:: Microsoft.Data.SqlClient v4.1.0

包:: Microsoft.Data.SqlClient v5.0.0

包:: Microsoft.Data.SqlClient v5.1.0

包:: Microsoft.Data.SqlClient v5.2.0

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

SqlParameter()	初始化 SqlParameter 类的新实例。
SqlParameter(String, SqlDbType)	使用提供的参数名称和数据类型初始化 SqlParameter 类的新实例。
SqlParameter(String, Object)	初始化 SqlParameter 类的新实例，该类使用参数名称和新 SqlParameter 的值。
SqlParameter(String, SqlDbType, Int32)	使用参数名称、SqlDbType 和大小初始化 SqlParameter 类的新实例。
SqlParameter(String, SqlDbType, Int32, String)	使用提供的参数名称、SqlDbType、大小和源列名初始化 SqlParameter 类的新实例。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	使用提供的参数名称、参数类型、参数大小、ParameterDirection、参数精度、参数小数位数、源列、要使用的 DataRowVersion 以及参数值初始化 SqlParameter 类的新实例。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	使用以下信息初始化 SqlParameter 类的新实例：参数名、参数类型、参数长度、参数传递方向、参数精度、参数的范围、源列名、DataRowVersion 的一个值、源列映射的布尔值、`SqlParameter` 的值、此 XML 实例的架构集所在的数据库名称、此 XML 实例的架构集所在的关系型架构，以及此参数的架构集的名称。

SqlParameter()

初始化 SqlParameter 类的新实例。

public:
 SqlParameter();

public SqlParameter ();

Public Sub New ()

示例

以下示例创建 SqlParameter 并设置其一些属性。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter();
        parameter.ParameterName = "@Description";
        parameter.IsNullable = true;
        parameter.SqlDbType = SqlDbType.VarChar;
        parameter.Direction = ParameterDirection.Output;
        parameter.Size = 88;

        command.Parameters.Add(parameter);
    }
}

适用于

SqlParameter(String, SqlDbType)

使用提供的参数名称和数据类型初始化 SqlParameter 类的新实例。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType)

参数

parameterName: String

要映射的参数的名称。

dbType: SqlDbType

SqlDbType 值之一。

例外

ArgumentException

参数 dbType 中提供的值不是有效的后端数据类型。

示例

以下示例创建 SqlParameter 并设置其一些属性。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command, string paramValue)
    {
        SqlParameter parameter = new SqlParameter("@Description", SqlDbType.VarChar);
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;
        parameter.Size = 88;
        parameter.Value = paramValue;

        command.Parameters.Add(parameter);
    }
}

注解

数据类型以及 Size 和 Precision （如果适用）是从参数的值推断出来的 dbType 。

适用于

SqlParameter(String, Object)

初始化 SqlParameter 类的新实例，该类使用参数名称和新 SqlParameter 的值。

public:
 SqlParameter(System::String ^ parameterName, System::Object ^ value);

public SqlParameter (string parameterName, object value);

new Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, value As Object)

参数

parameterName: String

要映射的参数的名称。

value: Object

作为 Object 的值的 SqlParameter。

示例

以下示例创建 SqlParameter 并设置其一些属性。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88, "Description");
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;

        command.Parameters.Add(parameter);
    }
}

注解

在参数中指定 Object 时，SqlDbType将从的 Microsoft .NET Framework类型推断出 Object。value

使用此构造函数的 SqlParameter 重载来指定整数参数值时，请谨慎。因为此重载接受 Object 类型的 value，所以当此值为零时，必须将整数值转换为 Object 类型，如下面的 C# 示例所示。

Parameter = new SqlParameter("@pname", (object)0);

如果不执行此转换，编译器会假定你正在尝试调用 SqlParameter(String, SqlDbType) 构造函数重载。

适用于

SqlParameter(String, SqlDbType, Int32)

使用参数名称、SqlDbType 和大小初始化 SqlParameter 类的新实例。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer)

参数

parameterName: String

要映射的参数的名称。

dbType: SqlDbType

SqlDbType 值之一。

size: Int32

参数的长度。

例外

ArgumentException

参数 dbType 中提供的值不是有效的后端数据类型。

示例

以下示例创建 SqlParameter 并设置其一些属性。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command,
        string paramValue)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88);
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;
        parameter.Value = paramValue;

        command.Parameters.Add(parameter);
    }
}

注解

如果未在参数中size显式设置，则从参数的值dbType推断出 Size。

适用于

SqlParameter(String, SqlDbType, Int32, String)

使用提供的参数名称、SqlDbType、大小和源列名初始化 SqlParameter 类的新实例。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::String ^ sourceColumn);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, string sourceColumn);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, sourceColumn As String)

参数

parameterName: String

要映射的参数的名称。

dbType: SqlDbType

SqlDbType 值之一。

size: Int32

参数的长度。

sourceColumn: String

如果在SqlParameter调用 Update(DataSet)>中使用此名称，则源列的名称 (SourceColumn) 。

例外

ArgumentException

参数 dbType 中提供的值不是有效的后端数据类型。

示例

以下示例创建 SqlParameter 并设置其一些属性。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 88, "Description");
        parameter.IsNullable = true;
        parameter.Direction = ParameterDirection.Output;

        command.Parameters.Add(parameter);
    }
}

注解

如果未在参数中size显式设置，则从参数的值dbType推断出 Size。

适用于

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

使用提供的参数名称、参数类型、参数大小、ParameterDirection、参数精度、参数小数位数、源列、要使用的 DataRowVersion 以及参数值初始化 SqlParameter 类的新实例。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, System::Object ^ value);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, object value);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, value As Object)

参数

parameterName: String

要映射的参数的名称。

dbType: SqlDbType

SqlDbType 值之一。

size: Int32

参数的长度。

direction: ParameterDirection

ParameterDirection 值之一。

isNullable: Boolean

如果字段的值可以为 null，则返回 true；否则，返回 false。

precision: Byte

所解析的 Value 的小数点左右两侧的总位数。

scale: Byte

所解析的 Value 的总小数位数。

sourceColumn: String

源列名 (SourceColumn)（如果在调用 Update(DataSet) 中使用了此 SqlParameter）。

sourceVersion: DataRowVersion

DataRowVersion 值之一。

value: Object

作为 Object 的值的 SqlParameter。

例外

ArgumentException

参数 dbType 中提供的值不是有效的后端数据类型。

示例

以下示例创建 SqlParameter 并设置其一些属性。

using Microsoft.Data.SqlClient;

class Program
{
    private static void AddSqlParameter(SqlCommand command)
    {
        SqlParameter parameter = new SqlParameter("@Description",
            SqlDbType.VarChar, 11, ParameterDirection.Input,
            true, 0, 0, "Description", DataRowVersion.Current,
            "garden hose");
        parameter.IsNullable = true;

        command.Parameters.Add(parameter);
    }
}

注解

如果未在和参数中sizeprecision显式设置大小和 Precision ，则从参数的值dbType推断它们。

适用于

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

使用以下信息初始化 SqlParameter 类的新实例：参数名、参数类型、参数长度、参数传递方向、参数精度、参数的范围、源列名、DataRowVersion 的一个值、源列映射的布尔值、SqlParameter 的值、此 XML 实例的架构集所在的数据库名称、此 XML 实例的架构集所在的关系型架构，以及此参数的架构集的名称。

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value, System::String ^ xmlSchemaCollectionDatabase, System::String ^ xmlSchemaCollectionOwningSchema, System::String ^ xmlSchemaCollectionName);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value, string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema, string xmlSchemaCollectionName);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object, xmlSchemaCollectionDatabase As String, xmlSchemaCollectionOwningSchema As String, xmlSchemaCollectionName As String)

参数

parameterName: String

要映射的参数的名称。

dbType: SqlDbType

SqlDbType 值之一。

size: Int32

参数的长度。

direction: ParameterDirection

ParameterDirection 值之一。

precision: Byte

所解析的 Value 的小数点左右两侧的总位数。

scale: Byte

所解析的 Value 的总小数位数。

sourceColumn: String

如果在SqlParameter调用 Update(DataSet)>中使用此名称，则源列的名称 (SourceColumn) 。

sourceVersion: DataRowVersion

DataRowVersion 值之一。

sourceColumnNullMapping: Boolean

如果源列可以为 null，则为true ；否则为 false。

value: Object

作为 Object 的值的 SqlParameter。

xmlSchemaCollectionDatabase: String

此 XML 实例的架构集合所在的数据库的名称。

xmlSchemaCollectionOwningSchema: String

此 XML 实例的架构集合所在的所属关系架构。

xmlSchemaCollectionName: String

此参数的架构集的名称。

注解

Size如果未在和 Precision 参数中显式设置和，则从参数的值dbType推断size出和 precision 。

适用于

通过

SqlParameter 构造函数

定义

重载

SqlParameter()

示例

适用于

SqlParameter(String, SqlDbType)

参数

例外

示例

注解

适用于

SqlParameter(String, Object)

参数

示例

注解

适用于

SqlParameter(String, SqlDbType, Int32)

参数

例外

示例

注解

适用于

SqlParameter(String, SqlDbType, Int32, String)

参数

例外

示例

注解

适用于

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

参数

例外

示例

注解

适用于

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

参数

注解

适用于

其他资源