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);
    }
}

설명

이 오버로드는 또는 binary와 같은 varchar 가변 길이 데이터 형식의 매개 변수를 추가할 때 유용합니다.

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

이 SqlParameter가 Update(DataSet)에 대한 호출에 사용되는 경우 소스 열(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");
    }
}