SqlParameterCollection 클래스

정의

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

어셈블리:: System.Data.dll

중요

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

에 있는 열SqlCommand에 대한 해당 매핑과 연결된 DataSet 매개 변수의 컬렉션을 나타냅니다. 이 클래스는 상속할 수 없습니다.

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

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

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

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

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

상속: Object

MarshalByRefObject
SqlParameterCollection

상속: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

특성: ListBindableAttribute

구현: ICollection IEnumerable IList IDataParameterCollection

예제

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

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. 저장 프로시저를 사용하면 기본값 없이 저장 프로시저에 선언된 모든 매개 변수를 제공해야 합니다. 기본값으로 선언된 매개 변수는 선택 사항입니다. 이렇게 하면 기본값 이외의 값을 지정할 수 있습니다.

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

속성

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

메서드

Name	Description
Add(Object)	지정된 SqlParameter 개체를 .에 SqlParameterCollection추가합니다.
Add(SqlParameter)	지정된 SqlParameter 개체를 .에 SqlParameterCollection추가합니다.
Add(String, Object)	사용되지 않음. 지정된 SqlParameter 개체를 .에 SqlParameterCollection추가합니다.
Add(String, SqlDbType, Int32, String)	SqlParameter SqlParameterCollection 매개 변수 이름, 데이터 형식 및 열 길이를 사용하여 a를 추가합니다.
Add(String, SqlDbType, Int32)	지정된 매개 변수 이름 및 크기가 지정된 경우 />에 a를 추가합니다.
Add(String, SqlDbType)	지정된 매개 변수 이름 및 데이터 형식에 a 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)

명시적 인터페이스 구현

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

확장명 메서드

Name	Description
AsParallel(IEnumerable)	쿼리의 병렬 처리를 사용하도록 설정합니다.
AsQueryable(IEnumerable)	IEnumerable IQueryable변환합니다.
Cast<TResult>(IEnumerable)	IEnumerable 요소를 지정된 형식으로 캐스팅합니다.
OfType<TResult>(IEnumerable)	지정된 형식에 따라 IEnumerable 요소를 필터링합니다.

적용 대상

추가 정보

피드백

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