SqlParameter 생성자

참조

정의

네임스페이스:: Microsoft.Data.SqlClient

어셈블리:: Microsoft.Data.SqlClient.dll

패키지:: Microsoft.Data.SqlClient v1.0.19269.1

패키지:: Microsoft.Data.SqlClient v1.1.4

패키지:: Microsoft.Data.SqlClient v2.0.1

패키지:: Microsoft.Data.SqlClient v2.1.4

패키지:: Microsoft.Data.SqlClient v3.0.1

패키지:: Microsoft.Data.SqlClient v3.1.0

패키지:: Microsoft.Data.SqlClient v4.0.1

패키지:: Microsoft.Data.SqlClient v4.1.0

패키지:: Microsoft.Data.SqlClient v5.0.0

패키지:: Microsoft.Data.SqlClient v5.1.0

패키지:: Microsoft.Data.SqlClient v5.2.0

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

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)	매개 변수 이름, 매개 변수 형식, 매개 변수 크기를 사용하는 , 매개 변수의 정밀도, 매개 변수의 배율, ParameterDirection, 매개 변수의 정밀도, 매개 변수의 소수 자릿수, 원본 열, 사용할 DataRowVersion 및 매개 변수 값을 사용하는 SqlParameter 클래스의 새 인스턴스를 초기화합니다.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	매개 변수 이름, 매개 변수의 형식, 매개 변수의 길이, 소스 열의 방향, 전체 자릿수, 소수 자릿수, DataRowVersion 값 중 하나, 소스 열 매핑에 대한 부울, `SqlParameter`의 값, 이 XML 인스턴스의 스키마 컬렉션이 있는 데이터베이스의 이름, 이 XML 인스턴스에 대 한 스키마 컬렉션이 있는 소유 관계형 스키마 및 이 매개 변수에 대한 스키마 컬렉션의 이름을 사용하는 SqlParameter 클래스의 새 인스턴스를 초기화합니다.

SqlParameter()

SqlParameter 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlParameter();

public SqlParameter ();

Public Sub New ()

예제

다음 예에서는 을 SqlParameter 만들고 일부 속성을 설정합니다.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

적용 대상

SqlParameter(String, SqlDbType)

매개 변수 이름과 데이터 형식을 사용하는 SqlParameter 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlParameter(System::String ^ parameterName, System::Data::SqlDbType dbType);

public SqlParameter (string parameterName, System.Data.SqlDbType dbType);

new Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, dbType As SqlDbType)

매개 변수

parameterName: String

매핑할 매개 변수의 이름입니다.

dbType: SqlDbType

SqlDbType 값 중 하나입니다.

예외

ArgumentException

dbType 매개 변수에 지정한 값이 올바르지 않은 백 엔드 데이터 형식입니다.

예제

다음 예에서는 을 SqlParameter 만들고 일부 속성을 설정합니다.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

설명

적절한 경우 데이터 형식 및 크기 및 Precision 는 매개 변수 값 dbType 에서 유추됩니다.

적용 대상

SqlParameter(String, Object)

매개 변수 이름과 새 SqlParameter의 값을 사용하는 SqlParameter 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlParameter(System::String ^ parameterName, System::Object ^ value);

public SqlParameter (string parameterName, object value);

new Microsoft.Data.SqlClient.SqlParameter : string * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Sub New (parameterName As String, value As Object)

매개 변수

parameterName: String

매핑할 매개 변수의 이름입니다.

value: Object

Object의 값인 SqlParameter입니다.

예제

다음 예에서는 을 SqlParameter 만들고 일부 속성을 설정합니다.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

설명

매개 변수에서 을 Objectvalue 지정하면 의 SqlDbType Microsoft .NET Framework 형식Object에서 가 유추됩니다.

생성자의 이 오버로드를 SqlParameter 사용하여 정수 매개 변수 값을 지정할 때는 주의해야 합니다. 이 오버로드는 Object 형식의 value를 사용하므로 다음 C# 예제와 같이 값이 0인 경우 정수 계열 값을 Object 형식으로 변환해야 합니다.

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int -> Microsoft.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 만들고 일부 속성을 설정합니다.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

설명

크기는 매개 변수에서 명시적으로 설정되지 않은 경우 매개 변수 값 dbType 에서 size 유추됩니다.

적용 대상

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * string -> Microsoft.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(DataSet)>에 사용되는 경우 SqlParameter 원본 열(SourceColumn)의 이름입니다.

예외

ArgumentException

dbType 매개 변수에 지정한 값이 올바르지 않은 백 엔드 데이터 형식입니다.

예제

다음 예에서는 을 SqlParameter 만들고 일부 속성을 설정합니다.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

설명

크기는 매개 변수에서 명시적으로 설정되지 않은 경우 매개 변수 값 dbType 에서 size 유추됩니다.

적용 대상

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

매개 변수 이름, 매개 변수 형식, 매개 변수 크기를 사용하는 , 매개 변수의 정밀도, 매개 변수의 배율, ParameterDirection, 매개 변수의 정밀도, 매개 변수의 소수 자릿수, 원본 열, 사용할 DataRowVersion 및 매개 변수 값을 사용하는 SqlParameter 클래스의 새 인스턴스를 초기화합니다.

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> Microsoft.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

이 SqlParameter가 Update(DataSet)에 대한 호출에 사용되는 경우 소스 열(SourceColumn)의 이름입니다.

sourceVersion: DataRowVersion

DataRowVersion 값 중 하나입니다.

value: Object

Object의 값인 SqlParameter입니다.

예외

ArgumentException

dbType 매개 변수에 지정한 값이 올바르지 않은 백 엔드 데이터 형식입니다.

예제

다음 예에서는 을 SqlParameter 만들고 일부 속성을 설정합니다.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

설명

및 매개 변수에서 명시적으로 설정되지 않은 경우 및Precision 는 매개 변수 값 dbType 에서 sizeprecision 유추됩니다.

적용 대상

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

매개 변수 이름, 매개 변수의 형식, 매개 변수의 길이, 소스 열의 방향, 전체 자릿수, 소수 자릿수, DataRowVersion 값 중 하나, 소스 열 매핑에 대한 부울, SqlParameter의 값, 이 XML 인스턴스의 스키마 컬렉션이 있는 데이터베이스의 이름, 이 XML 인스턴스에 대 한 스키마 컬렉션이 있는 소유 관계형 스키마 및 이 매개 변수에 대한 스키마 컬렉션의 이름을 사용하는 SqlParameter 클래스의 새 인스턴스를 초기화합니다.

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 Microsoft.Data.SqlClient.SqlParameter : string * System.Data.SqlDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj * string * string * string -> Microsoft.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(DataSet)>에 사용되는 경우 SqlParameter 원본 열(SourceColumn)의 이름입니다.

sourceVersion: DataRowVersion

DataRowVersion 값 중 하나입니다.

sourceColumnNullMapping: Boolean

원본 열에 null이 허용되면 true이고, 허용되지 않으면 false입니다.

value: Object

Object의 값인 SqlParameter입니다.

xmlSchemaCollectionDatabase: String

이 XML 인스턴스의 스키마 컬렉션이 있는 데이터베이스의 이름입니다.

xmlSchemaCollectionOwningSchema: String

이 XML 인스턴스의 스키마 컬렉션이 있는 소유 관계형 스키마입니다.

xmlSchemaCollectionName: String

이 매개 변수에 대한 스키마 컬렉션의 이름입니다.

설명

Size 및 는 및 Precisionprecision 매개 변수에서 명시적으로 설정되지 않은 경우 매개 변수 값 dbType 에서 size 유추됩니다.

적용 대상

다음을 통해 공유

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)

매개 변수

설명

적용 대상

추가 리소스