SqlParameter 생성자

정의

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

어셈블리:: System.Data.dll

중요

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

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

오버로드

Name	Description
SqlParameter()	SqlParameter 클래스의 새 인스턴스를 초기화합니다.
SqlParameter(String, SqlDbType)	매개 변수 이름과 데이터 형식을 SqlParameter 사용하는 클래스의 새 인스턴스를 초기화합니다.
SqlParameter(String, Object)	매개 변수 이름과 새 값을 사용하는 클래스의 새 SqlParameter인스턴스 SqlParameter 를 초기화합니다.
SqlParameter(String, SqlDbType, Int32)	매개 변수 이름, 크기 및 크기를 사용하는 클래스의 SqlParameter 새 인스턴스를 SqlDbType초기화합니다.
SqlParameter(String, SqlDbType, Int32, String)	매개 변수 이름, SqlDbType크기 및 원본 열 이름을 사용하는 클래스의 새 인스턴스 SqlParameter 를 초기화합니다.
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 부울, 값, 이 XML 인스턴스의 스키마 컬렉션이 있는 데이터베이스의 이름을 사용하는 클래스의 `SqlParameter`새 SqlParameter 인스턴스를 초기화합니다. 이 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

추가 정보

적용 대상

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

추가 정보

적용 대상

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 Object Microsoft .NET 형식에서 유추됩니다.

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

Parameter = new SqlParameter("@pname", (object)0);

이 변환을 수행하지 않으면 컴파일러는 생성자 오버로드를 호출 SqlParameter(String, SqlDbType) 하려고 한다고 가정합니다.

추가 정보

적용 대상

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

설명

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

추가 정보

적용 대상

SqlParameter(String, SqlDbType, Int32, String)

매개 변수 이름, SqlDbType크기 및 원본 열 이름을 사용하는 클래스의 새 인스턴스 SqlParameter 를 초기화합니다.

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

설명

매개 변수에 명시적으로 설정되지 않은 경우 크기 는 매개 변수 값 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 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

true필드 값이 null일 수 있으면 그렇지 않으면 . 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

설명

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

추가 정보

적용 대상

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

매개 변수 이름, 매개 변수의 형식, 매개 변수의 길이, 방향, 전체 자릿수, 소수 자릿수, 원본 열 이름, 값 중 하나, 원본 열 매핑의 DataRowVersion 부울, 값, 이 XML 인스턴스의 스키마 컬렉션이 있는 데이터베이스의 이름을 사용하는 클래스의 SqlParameter새 SqlParameter 인스턴스를 초기화합니다. 이 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을 허용하면 그렇지 않은 경우

value: Object

Object 의 값SqlParameter입니다.

xmlSchemaCollectionDatabase: String

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

xmlSchemaCollectionOwningSchema: String

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

xmlSchemaCollectionName: String

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

설명

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

추가 정보

적용 대상

피드백

이 페이지가 도움이 되었나요?