SqlParameterCollection.Add 方法

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

多載

Add(SqlParameter)	將指定的 SqlParameter 物件加入至 SqlParameterCollection。
Add(Object)	將指定的 SqlParameter 物件加入至 SqlParameterCollection。
Add(String, SqlDbType)	將 SqlParameter 加入至 SqlParameterCollection (已知參數名稱和資料類型)。
Add(String, SqlDbType, Int32)	將 SqlParameter 加入至具有指定參數名稱、SqlParameterCollection 和大小的 SqlDbType。
Add(String, SqlDbType, Int32, String)	將 SqlParameter 加入至 SqlParameterCollection (已知參數名稱、資料類型和資料行長度)。

Add(SqlParameter)

將指定的 SqlParameter 物件加入至 SqlParameterCollection。

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(Microsoft::Data::SqlClient::SqlParameter ^ value);

public Microsoft.Data.SqlClient.SqlParameter Add (Microsoft.Data.SqlClient.SqlParameter value);

override this.Add : Microsoft.Data.SqlClient.SqlParameter -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (value As SqlParameter) As SqlParameter

參數

value

SqlParameter

要加入至集合的 SqlParameter。

傳回

SqlParameter

新的 SqlParameter 物件。

例外狀況

ArgumentException

value 參數中指定的 SqlParameter 已經加入至這個或另一個 SqlParameterCollection。

InvalidCastException

傳遞的參數不是 SqlParameter。

ArgumentNullException

value 參數為 null。

範例

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        command.Parameters.Add(new SqlParameter("Description", "Beverages"));
    }
}

Add(Object)

將指定的 SqlParameter 物件加入至 SqlParameterCollection。

public:
 override int Add(System::Object ^ value);

public override int Add (object value);

override this.Add : obj -> int

Public Overrides Function Add (value As Object) As Integer

參數

value

Object

Object。

傳回

Int32

新 SqlParameter 物件的索引。

Add(String, SqlDbType)

將 SqlParameter 加入至 SqlParameterCollection (已知參數名稱和資料類型)。

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType);

override this.Add : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType) As SqlParameter

參數

parameterName

String

參數名稱。

sqlDbType

SqlDbType

其中一個 SqlDbType 值。

傳回

SqlParameter

新的 SqlParameter 物件。

範例

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = command.Parameters.Add(
            "@Description", SqlDbType.NVarChar);
        param.Size = 16;
        param.Value = "Beverages";
    }
}

Add(String, SqlDbType, Int32)

將 SqlParameter 加入至具有指定參數名稱、SqlParameterCollection 和大小的 SqlDbType。

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size);

override this.Add : string * System.Data.SqlDbType * int -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer) As SqlParameter

參數

parameterName

String

參數名稱。

sqlDbType

SqlDbType

要加入集合之 SqlParameter 的 SqlDbType。

size

Int32

大小為 Int32。

傳回

SqlParameter

新的 SqlParameter 物件。

範例

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand command)
    {
        SqlParameter param = new SqlParameter(
            "@Description", SqlDbType.NVarChar, 16);
        param.Value = "Beverages";
        command.Parameters.Add(param);
    }
}

備註

當您新增變數長度資料類型的參數，例如 varchar 或 binary 時，這個多載很有用。

Add(String, SqlDbType, Int32, String)

將 SqlParameter 加入至 SqlParameterCollection (已知參數名稱、資料類型和資料行長度)。

public:
 Microsoft::Data::SqlClient::SqlParameter ^ Add(System::String ^ parameterName, System::Data::SqlDbType sqlDbType, int size, System::String ^ sourceColumn);

public Microsoft.Data.SqlClient.SqlParameter Add (string parameterName, System.Data.SqlDbType sqlDbType, int size, string sourceColumn);

override this.Add : string * System.Data.SqlDbType * int * string -> Microsoft.Data.SqlClient.SqlParameter

Public Function Add (parameterName As String, sqlDbType As SqlDbType, size As Integer, sourceColumn As String) As SqlParameter

參數

parameterName

String

參數名稱。

sqlDbType

SqlDbType

其中一個 SqlDbType 值。

size

Int32

資料行長度。

sourceColumn

String

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

傳回

SqlParameter

新的 SqlParameter 物件。

範例

using Microsoft.Data.SqlClient;

public class Sample
{
    public void AddSqlParameter(SqlCommand cmd)
    {
        SqlParameter p1 = cmd.Parameters.Add("@Description", SqlDbType.NVarChar, 16, "Description");
    }
}