SqlParameter 建構函式

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

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

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

另請參閱

• 命令和參數
• DataAdapter 的參數
• SQL Server and ADO.NET (SQL Server 和 ADO.NET)
• ADO.NET 概觀 \(部分機器翻譯\)

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

備註

數據類型，如果適當，則會從 參數的值dbType推斷和 大小Precision。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

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) 建構函式多載。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

SqlParameter(String, SqlDbType, Int32)

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

備註

如果未在 參數中size明確設定，則會從 參數的值dbType推斷 Size。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

SqlParameter(String, SqlDbType, Int32, String)

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

如果在對 Update 的呼叫中使用這個 SqlParameter，則為來源資料行名稱 (SourceColumn)。

例外狀況

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推斷 Size。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

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

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

若欄位值可以是 Null，即為 true；否則為 false。

precision

Byte

Value 所解析的小數點左右側的位數總數。

scale

Byte

Value 所解析的小數點位數的總數。

sourceColumn

String

如果在對 Update 的呼叫中使用這個 SqlParameter，則為來源資料行名稱 (SourceColumn)。

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

備註

如果未在 與參數中size明確設定，則會從 參數的值dbType推斷 Size Precision 和 precision 。

另請參閱

• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

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

如果在對 Update 的呼叫中使用這個 SqlParameter，則為來源資料行名稱 (SourceColumn)。

sourceVersion

DataRowVersion

其中一個 DataRowVersion 值。

sourceColumnNullMapping

Boolean

如果來源資料行可為 Null，則為 true；否則為 false。

value

Object

Object，是 SqlParameter 的值。

xmlSchemaCollectionDatabase

String

這個 XML 執行個體結構描述集合所在的資料庫名稱。

xmlSchemaCollectionOwningSchema

String

這個 XML 執行個體結構描述集合所在的主控關聯式結構描述。

xmlSchemaCollectionName

String

此參數的結構描述集合名稱。

備註

Size如果在 與參數中size未明確設定，則會Precision從 參數的值dbType推斷 和 precision 。

另請參閱

• SQL Server 資料類型和 ADO.NET
• 命令和參數 (ADO.NET)
• DataAdapter 的參數 (ADO.NET)
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)