SqlParameter 建構函式

定義

命名空間:: System.Data.SqlClient

組件:: System.Data.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 SqlParameter 類別的新執行個體。

多載

名稱	Description
SqlParameter()	初始化 SqlParameter 類別的新執行個體。
SqlParameter(String, SqlDbType)	初始化使用參數名稱與資料型態的新類別實例 SqlParameter 。
SqlParameter(String, Object)	初始化一個使用參數名稱及新SqlParameter值的類別新實例SqlParameter。
SqlParameter(String, SqlDbType, Int32)	初始化一個使用參數名稱、參數 SqlDbType、與大小的類別新實例SqlParameter。
SqlParameter(String, SqlDbType, Int32, String)	初始化一個新的類別實例 SqlParameter ，使用參數名稱、大小 SqlDbType及來源欄位名稱。
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	初始化一個新的類別實例 SqlParameter ，使用參數名稱、參數型別、參數大小、a ParameterDirection、參數的精度、參數的縮放、來源欄位、 DataRowVersion a to use 以及參數值。
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 是從 Object 的Microsoft .NET型推斷出來的。

使用這種建構子過載 SqlParameter 來指定整數參數值時，請特別小心。由於此超載取的是一個 value 型別 Object為，當值為零時，你必須將整數值轉換為型 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)

初始化一個新的類別實例 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

如果SqlParameter在呼叫時Update使用來源欄位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推斷大小。

另請參閱

適用於

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

初始化一個新的類別實例 SqlParameter ，使用參數名稱、參數型別、參數大小、a ParameterDirection、參數的精度、參數的縮放、來源欄位、 DataRowVersion a to use 以及參數值。

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如果欄位的值可以為零;否則，。 false

precision: Byte

解決到小數點 Value 左右兩位的總數字數。

scale: Byte

解決到的小數 Value 點數總數。

sourceColumn: String

如果SqlParameter在呼叫時Update使用來源欄位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 和 Precision 未在 and precision 參數中明確設定size，則可從參數值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

如果SqlParameter在呼叫時Update使用來源欄位SourceColumn名稱（），則為。

sourceVersion: DataRowVersion

這是其中一項 DataRowVersion 價值。

sourceColumnNullMapping: Boolean

true 如果來源欄位是可空的; false 如果不是的話。

value: Object

且 Object 是的 SqlParameter值。

xmlSchemaCollectionDatabase: String

該 XML 實例結構集合所在的資料庫名稱。

xmlSchemaCollectionOwningSchema: String

擁有此 XML 實例的結構集合所在的關聯結構。

xmlSchemaCollectionName: String

此參數的結構集合名稱。

備註

Size若和 Precision 未明確設定於size參數precision中，則可從參數值dbType推斷出。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？