SqlParameterCollection 클래스

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.dll

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

상속

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

특성

ListBindableAttribute

예제

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

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

Public Sub 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)
End Sub

설명

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

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

속성

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

메서드

Add(Object)	SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.
Add(SqlParameter)	SqlParameter에 지정한 SqlParameterCollection 개체를 추가합니다.
Add(String, Object)	사용되지 않음. 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에 복사합니다.
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetEnumerator()	SqlParameterCollection를 반복하는 열거자를 반환합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetLifetimeService()	이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetParameter(Int32)	컬렉션의 지정된 인덱스에 있는 DbParameter 개체를 반환합니다. (다음에서 상속됨 DbParameterCollection)
GetParameter(String)	지정된 이름의 DbParameter 개체를 반환합니다. (다음에서 상속됨 DbParameterCollection)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IndexOf(Object)	컬렉션 내의 지정된 Object의 위치를 가져옵니다.
IndexOf(SqlParameter)	컬렉션 내의 지정된 SqlParameter의 위치를 가져옵니다.
IndexOf(String)	지정된 이름을 가진 SqlParameter의 위치를 가져옵니다.
InitializeLifetimeService()	이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
Insert(Int32, Object)	Object의 지정된 인덱스에 SqlParameterCollection를 삽입합니다.
Insert(Int32, SqlParameter)	SqlParameter의 지정된 인덱스에 SqlParameterCollection 개체를 삽입합니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Remove(Object)	지정된 SqlParameter를 컬렉션에서 제거합니다.
Remove(SqlParameter)	지정된 SqlParameter를 컬렉션에서 제거합니다.
RemoveAt(Int32)	SqlParameter의 지정된 인덱스에서 SqlParameterCollection를 제거합니다.
RemoveAt(String)	지정된 이름을 가진 SqlParameter를 SqlParameterCollection에서 제거합니다.
SetParameter(Int32, DbParameter)	지정된 인덱스에 있는 DbParameter 개체를 새 값으로 설정합니다. (다음에서 상속됨 DbParameterCollection)
SetParameter(String, DbParameter)	지정된 이름의 DbParameter 개체를 새 값으로 설정합니다. (다음에서 상속됨 DbParameterCollection)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

IDataParameterCollection.Item[String]	지정한 인덱스에 있는 매개 변수를 가져오거나 설정합니다. (다음에서 상속됨 DbParameterCollection)
IList.Item[Int32]	지정한 인덱스에 있는 요소를 가져오거나 설정합니다. (다음에서 상속됨 DbParameterCollection)

확장 메서드

Cast<TResult>(IEnumerable)	IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.
OfType<TResult>(IEnumerable)	지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.
AsParallel(IEnumerable)	쿼리를 병렬화할 수 있도록 합니다.
AsQueryable(IEnumerable)	IEnumerable을 IQueryable로 변환합니다.

추가 정보

• 명령 및 매개 변수(ADO.NET)
• DataAdapter 매개 변수(ADO.NET)
• .NET Framework Data Provider for SQL Server 사용
• ADO.NET 개요