다음을 통해 공유


SqlParameter 생성자

정의

오버로드

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 값 중 하나입니다.

예외

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

매개 변수의 길이입니다.

예외

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)의 이름입니다.

예외

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

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

sourceVersion
DataRowVersion

DataRowVersion 값 중 하나입니다.

value
Object

Object의 값인 SqlParameter입니다.

예외

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 유추됩니다.

적용 대상