SqlParameterCollection 클래스

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

SqlCommand 및 DataSet의 열에 대한 개별 매핑과 관련된 매개 변수 컬렉션을 나타냅니다. 이 클래스는 상속될 수 없습니다.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

상속

DbParameterCollection

SqlParameterCollection

특성

ListBindableAttribute

예제

다음 예제에서는 컬렉션을 통해 의 SqlParameter 여러 인스턴스를 SqlParameterCollection 만듭니다. 매개 변수는 데이터 원본 내에서 데이터를 선택하고 를 채우는 DataSet데 사용됩니다. 이 코드에서는 DataSet 적절한 스키마, 명령 및 연결을 사용하여 및 SqlDataAdapter 가 이미 생성되었다고 가정합니다.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


    public void AddSqlParameters()
    {
        // ...
        // create categoriesDataSet and categoriesAdapter
        // ...

        categoriesAdapter.SelectCommand.Parameters.Add(
          "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
        categoriesAdapter.SelectCommand.Parameters.Add(
          "@SerialNum", SqlDbType.Int).Value = 239;
        categoriesAdapter.Fill(categoriesDataSet);

    }
}

설명

명령에 저장 프로시저 이름이 아닌 임시 SQL 문이 포함된 경우 컬렉션의 매개 변수 수는 명령 텍스트 내의 매개 변수 자리 표시자 수와 같아야 합니다. 그렇지 않으면 SQL Server 오류가 발생합니다. 저장 프로시저를 사용하면 기본값 없이 저장 프로시저에 선언된 모든 매개 변수를 제공해야 합니다. 기본값으로 선언된 매개 변수는 선택 사항입니다. 이렇게 하면 기본값 이외의 값을 지정할 수 있습니다.

매개 변수를 사용하는 방법을 보여주는 추가 샘플 코드에 대한 자세한 내용은 명령 및 매개 변수를 참조하세요.

속성

Count	SqlParameterCollection의 요소 수가 포함된 정수를 반환합니다. 읽기 전용입니다.
IsFixedSize	SqlParameterCollection의 크기가 고정되어 있는지 여부를 나타내는 값을 가져옵니다.
IsReadOnly	SqlParameterCollection이 읽기 전용인지 여부를 나타내는 값을 가져옵니다.
Item[Int32]	지정된 인덱스의 SqlParameter를 가져옵니다.
Item[String]	지정된 이름을 가진 SqlParameter를 가져옵니다.
SyncRoot	SqlParameterCollection에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.

메서드

Add(Object)	SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.
Add(SqlParameter)	SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.
Add(String, SqlDbType)	매개 변수 이름과 데이터 형식을 사용하여 SqlParameter에 SqlParameterCollection를 추가합니다.
Add(String, SqlDbType, Int32)	지정된 매개 변수 이름, SqlParameter 및 크기가 제공된 경우 SqlParameterCollection를 SqlDbType에 추가합니다.
Add(String, SqlDbType, Int32, String)	매개 변수 이름, 데이터 형식 및 열 길이를 사용하여 SqlParameter에 SqlParameterCollection를 추가합니다.
AddRange(Array)	SqlParameterCollection 끝에 값 배열을 추가합니다.
AddRange(SqlParameter[])	SqlParameter 끝에 SqlParameterCollection 값의 배열을 추가합니다.
AddWithValue(String, Object)	SqlParameterCollection 끝에 값을 추가합니다.
Clear()	SqlParameter에서 SqlParameterCollection 개체를 모두 제거합니다.
Contains(Object)	지정된 Object가 이 SqlParameterCollection에 포함되는지 여부를 확인합니다.
Contains(SqlParameter)	지정된 SqlParameter가 이 SqlParameterCollection에 포함되는지 여부를 확인합니다.
Contains(String)	지정된 매개 변수 이름이 이 SqlParameterCollection에 있는지 여부를 확인합니다.
CopyTo(Array, Int32)	현재 SqlParameterCollection의 모든 요소를 지정된 대상 Array 인덱스부터 지정된 1차원 Array에 복사합니다.
CopyTo(SqlParameter[], Int32)	현재 SqlParameterCollection의 모든 요소를 지정된 대상 인덱스부터 지정된 SqlParameterCollection에 복사합니다.
GetEnumerator()	SqlParameterCollection를 반복하는 열거자를 반환합니다.
IndexOf(Object)	컬렉션 내의 지정된 Object의 위치를 가져옵니다.
IndexOf(SqlParameter)	컬렉션 내의 지정된 SqlParameter의 위치를 가져옵니다.
IndexOf(String)	지정된 이름을 가진 SqlParameter의 위치를 가져옵니다.
Insert(Int32, Object)	Object의 지정된 인덱스에 SqlParameterCollection를 삽입합니다.
Insert(Int32, SqlParameter)	SqlParameter의 지정된 인덱스에 SqlParameterCollection 개체를 삽입합니다.
Remove(Object)	지정된 SqlParameter를 컬렉션에서 제거합니다.
Remove(SqlParameter)	지정된 SqlParameter를 컬렉션에서 제거합니다.
RemoveAt(Int32)	SqlParameter의 지정된 인덱스에서 SqlParameterCollection를 제거합니다.
RemoveAt(String)	지정된 이름을 가진 SqlParameter를 SqlParameterCollection에서 제거합니다.