SqlParameterCollection 클래스

정의

SqlCommand와 연결된 매개 변수의 컬렉션과 DataSet의 열에 대한 개별 매핑을 나타냅니다.Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
상속
SqlParameterCollection
특성
구현

예제

다음 예제에서는 SqlParameterCollection 컬렉션을 통해 SqlParameter의 여러 인스턴스를 만듭니다.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. 매개 변수는 데이터 원본 내에서 데이터를 선택 하 고 DataSet를 채우는 데 사용 됩니다.The parameters are used to select data within the data source and populate the DataSet. 이 코드에서는 적절 한 스키마, 명령 및 연결을 사용 하 여 DataSetSqlDataAdapter 이미 생성 된 것으로 가정 합니다.This code assumes that a DataSet and a SqlDataAdapter have already been created with the appropriate schema, commands, and connection.

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 오류가 발생 합니다.If the command contains an ad hoc SQL statement, as opposed to a stored-procedure name, the number of the parameters in the collection must be equal to the number of parameter placeholders within the command text, or SQL Server raises an error. 저장 프로시저를 사용 하 여 저장 프로시저에서 기본 값 없이 선언 된 모든 매개 변수를 제공 해야 합니다.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. 기본값으로 선언 된 매개 변수는 선택 사항입니다.Parameters declared with a default value are optional. 이를 통해 기본값 이외의 값을 지정할 수 있습니다.This lets you specify a value other than the default.

매개 변수를 사용 하는 방법을 보여 주는 추가 샘플 코드에 대 한 자세한 내용은 명령 및 매개 변수를 참조 하세요.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

속성

Count

SqlParameterCollection의 요소 수가 포함된 정수를 반환합니다.Returns an Integer that contains the number of elements in the SqlParameterCollection. 읽기 전용입니다.Read-only.

IsFixedSize

SqlParameterCollection의 크기가 고정되어 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsReadOnly

SqlParameterCollection이 읽기 전용인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the SqlParameterCollection is read-only.

IsSynchronized

SqlParameterCollection이 동기화되었는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the SqlParameterCollection is synchronized.

Item[Int32]

지정된 인덱스의 SqlParameter를 가져옵니다.Gets the SqlParameter at the specified index.

Item[String]

지정된 이름을 가진 SqlParameter를 가져옵니다.Gets the SqlParameter with the specified name.

SyncRoot

SqlParameterCollection에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.Gets an object that can be used to synchronize access to the SqlParameterCollection.

메서드

Add(Object)

지정된 SqlParameter 개체를 SqlParameterCollection에 추가합니다.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

지정된 SqlParameter 개체를 SqlParameterCollection에 추가합니다.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, Object)

지정된 SqlParameter 개체를 SqlParameterCollection에 추가합니다.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType)

매개 변수 이름과 데이터 형식을 사용하여 SqlParameterSqlParameterCollection를 추가합니다.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, SqlDbType, Int32)

지정된 매개 변수 이름, SqlParameter 및 크기가 제공된 경우 SqlParameterCollectionSqlDbType에 추가합니다.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String)

매개 변수 이름, 데이터 형식 및 열 길이를 사용하여 SqlParameterSqlParameterCollection를 추가합니다.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

AddRange(Array)

SqlParameterCollection 끝에 값 배열을 추가합니다.Adds an array of values to the end of the SqlParameterCollection.

AddRange(SqlParameter[])

SqlParameter 끝에 SqlParameterCollection 값의 배열을 추가합니다.Adds an array of SqlParameter values to the end of the SqlParameterCollection.

AddWithValue(String, Object)

SqlParameterCollection 끝에 값을 추가합니다.Adds a value to the end of the SqlParameterCollection.

Clear()

SqlParameter에서 SqlParameterCollection 개체를 모두 제거합니다.Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object)

지정된 Object가 이 SqlParameterCollection에 포함되는지 여부를 확인합니다.Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter)

지정된 SqlParameter가 이 SqlParameterCollection에 포함되는지 여부를 확인합니다.Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String)

지정된 매개 변수 이름이 이 SqlParameterCollection에 있는지 여부를 확인합니다.Determines whether the specified parameter name is in this SqlParameterCollection.

CopyTo(Array, Int32)

현재 SqlParameterCollection의 모든 요소를 지정된 대상 Array 인덱스부터 지정된 1차원 Array에 복사합니다.Copies all the elements of the current SqlParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

CopyTo(SqlParameter[], Int32)

현재 SqlParameterCollection의 모든 요소를 지정된 대상 인덱스부터 지정된 SqlParameterCollection에 복사합니다.Copies all the elements of the current SqlParameterCollection to the specified SqlParameterCollection starting at the specified destination index.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetEnumerator()

SqlParameterCollection를 반복하는 열거자를 반환합니다.Returns an enumerator that iterates through the SqlParameterCollection.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
IndexOf(Object)

컬렉션 내의 지정된 Object의 위치를 가져옵니다.Gets the location of the specified Object within the collection.

IndexOf(SqlParameter)

컬렉션 내의 지정된 SqlParameter의 위치를 가져옵니다.Gets the location of the specified SqlParameter within the collection.

IndexOf(String)

지정된 이름을 가진 SqlParameter의 위치를 가져옵니다.Gets the location of the specified SqlParameter with the specified name.

InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
Insert(Int32, Object)

Object의 지정된 인덱스에 SqlParameterCollection를 삽입합니다.Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter)

SqlParameter의 지정된 인덱스에 SqlParameterCollection 개체를 삽입합니다.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
Remove(Object)

지정된 SqlParameter를 컬렉션에서 제거합니다.Removes the specified SqlParameter from the collection.

Remove(SqlParameter)

지정된 SqlParameter를 컬렉션에서 제거합니다.Removes the specified SqlParameter from the collection.

RemoveAt(Int32)

SqlParameter의 지정된 인덱스에서 SqlParameterCollection를 제거합니다.Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String)

지정된 이름을 가진 SqlParameterSqlParameterCollection에서 제거합니다.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

확장 메서드

Cast<TResult>(IEnumerable)

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

쿼리를 병렬화할 수 있도록 합니다.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable로 변환합니다.Converts an IEnumerable to an IQueryable.

적용 대상

추가 정보