SqlParameter 建構函式

參考

定義

命名空間:: System.Data.SqlClient

組件:: System.Data.SqlClient.dll

組件:: System.Data.dll

套件:: System.Data.SqlClient v4.8.6

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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()

初始化 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 概觀 \(部分機器翻譯\)

適用於

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)

參數

備註

另請參閱

適用於

意見反應

其他資源