SqlParameter 构造函数

参考

定义

命名空间:: System.Data.SqlClient

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

程序集:: System.Data.dll

程序集:: netstandard.dll, System.Data.SqlClient.dll

包:: System.Data.SqlClient v4.8.6

重要

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

初始化 SqlParameter 类的新实例。

重载

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 设置其一些属性。

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter()
    With parameter
        .ParameterName = "@Description"
        .IsNullable = True
        .SqlDbType = SqlDbType.VarChar
        .Direction = ParameterDirection.Output
        .Size = 88
    End With

    command.Parameters.Add(parameter)
End Sub

另请参阅

适用于

SqlParameter(String, SqlDbType)

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

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

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

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

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

参数

parameterName: String

要映射的参数的名称。

dbType: SqlDbType

SqlDbType 值之一。

例外

ArgumentException

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

示例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Size = 88
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

注解

数据类型，如果合适，大小和 Precision 是从参数的值推断出来的 dbType 。

另请参阅

适用于

SqlParameter(String, Object)

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

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

public SqlParameter (string parameterName, object value);

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

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

参数

parameterName: String

要映射的参数的名称。

value: Object

作为 Object 的值的 SqlParameter。

示例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

注解

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

使用此构造函数重 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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> System.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 设置其一些属性。

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand, _
    ByVal paramValue As String)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88)
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
        .Value = paramValue
    End With

    command.Parameters.Add(parameter)
End Sub

注解

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

另请参阅

适用于

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> System.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

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

例外

ArgumentException

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

示例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

注解

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

另请参阅

适用于

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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.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 中使用了此 SqlParameter）。

sourceVersion: DataRowVersion

DataRowVersion 值之一。

value: Object

作为 Object 的值的 SqlParameter。

例外

ArgumentException

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

示例

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

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);
}

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 11, ParameterDirection.Input, _
        True, 0, 0, "Description", DataRowVersion.Current, _
        "garden hose")
    parameter.IsNullable = True

    command.Parameters.Add(parameter)
End Sub

注解

如果未在和参数中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 System.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> System.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

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

sourceVersion: DataRowVersion

DataRowVersion 值之一。

sourceColumnNullMapping: Boolean

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

value: Object

作为 Object 的值的 SqlParameter。

xmlSchemaCollectionDatabase: String

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

xmlSchemaCollectionOwningSchema: String

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

xmlSchemaCollectionName: String

此参数的架构集的名称。

注解

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

另请参阅

适用于

通过

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)

参数

注解

另请参阅

适用于

其他资源