SqlParameter 构造函数

定义

命名空间:: System.Data.SqlClient

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

程序集:: System.Data.dll

重要

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

初始化 SqlParameter 类的新实例。

重载

名称	说明
SqlParameter()	初始化 SqlParameter 类的新实例。
SqlParameter(String, SqlDbType)	初始化使用参数名称和数据类型的 SqlParameter 类的新实例。
SqlParameter(String, Object)	初始化类的新实例，该实例 SqlParameter 使用参数名称和新 SqlParameter值。
SqlParameter(String, SqlDbType, Int32)	初始化使用参数名称、大小SqlParameter和大小的类的新实例SqlDbType。
SqlParameter(String, SqlDbType, Int32, String)	初始化使用参数名称、SqlParameter大小和源列名称的类的新实例SqlDbType。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	初始化使用参数名称、参数类型、参数大小、参数大小、SqlParameter参数精度、参数小数位数、源列、ParameterDirection要使用的参数和参数值的新实例DataRowVersion。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	初始化类的新实例，该类 SqlParameter 使用参数名称、参数的类型、参数方向的长度、精度、刻度、源列的名称、值之一 DataRowVersion 、源列映射的布尔值、值的 `SqlParameter`布尔值、此 XML 实例的架构集合所在的数据库的名称、拥有此 XML 实例的架构集合所在的关系架构，以及此参数的架构集合的名称。

SqlParameter()

Source:: System.Data.SqlClient.notsupported.cs

初始化 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)

Source:: System.Data.SqlClient.notsupported.cs

初始化使用参数名称和数据类型的 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)

Source:: System.Data.SqlClient.notsupported.cs

初始化类的新实例，该实例 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

注解

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

使用此构造函数重载 SqlParameter 指定整数参数值时请小心。由于此重载采用某种 value 类型 Object，因此当该值为零时，必须将整型值转换为 Object 类型，如以下 C# 示例所示。

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

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

另请参阅

适用于

SqlParameter(String, SqlDbType, Int32)

Source:: System.Data.SqlClient.notsupported.cs

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

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

注解

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

另请参阅

适用于

SqlParameter(String, SqlDbType, Int32, String)

Source:: System.Data.SqlClient.notsupported.cs

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

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调用SqlParameter中使用此名称，则为源列的名称。Update。

例外

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

注解

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

另请参阅

适用于

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

Source:: System.Data.SqlClient.notsupported.cs

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

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

true 如果字段的值可以为 null，则为 ;否则，为 false.

precision: Byte

解析到 Value 的小数点左侧和右侧的位数。

scale: Byte

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

sourceColumn: String

如果在SourceColumn调用SqlParameter中使用此名称，则为源列的名称。Update。

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

注解

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

另请参阅

适用于

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

Source:: System.Data.SqlClient.notsupported.cs

初始化类的新实例，该类 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调用SqlParameter中使用此名称，则为源列的名称。Update。

sourceVersion: DataRowVersion

其中一个 DataRowVersion 值。

sourceColumnNullMapping: Boolean

true 如果源列可为 null，则为 false 如果不是，则为

value: Object

一个 Object 是值 SqlParameter。

xmlSchemaCollectionDatabase: String

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

xmlSchemaCollectionOwningSchema: String

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

xmlSchemaCollectionName: String

此参数的架构集合的名称。

注解

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

另请参阅

适用于

反馈

此页面是否有帮助？