ObjectParameterCollection.Add(ObjectParameter) 메서드

정의

지정된 ObjectParameter를 컬렉션에 추가합니다.

public:
 virtual void Add(System::Data::Objects::ObjectParameter ^ parameter);
public void Add (System.Data.Objects.ObjectParameter parameter);
abstract member Add : System.Data.Objects.ObjectParameter -> unit
override this.Add : System.Data.Objects.ObjectParameter -> unit
Public Sub Add (parameter As ObjectParameter)

매개 변수

parameter
ObjectParameter

컬렉션에 추가할 매개 변수입니다.

구현

예외

parameter 인수가 null인 경우

parameter 인수가 컬렉션에 이미 있는 경우. 이 동작은 중복 항목을 허용하는 대다수 컬렉션의 동작과 다릅니다.

또는

parameter 인수와 이름이 동일한 다른 매개 변수가 컬렉션이 이미 있는 경우. 조회할 때는 대/소문자가 구분되지 않습니다. 이 동작은 대다수 컬렉션의 동작과 다르며 Dictionary<TKey,TValue>의 동작과 비슷합니다.

parameter의 형식이 유효하지 않은 경우

예제

다음은 컬렉션에 새 매개 변수를 추가하는 예제입니다. @FSHO2@그런 다음 ObjectParameterCollection을 반복하여 컬렉션에 있는 각 매개 변수의 이름, 형식 및 값을 표시합니다.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE contact FROM AdventureWorksEntities.Contacts
        AS contact WHERE contact.LastName = @ln AND contact.FirstName = @fn";

    ObjectQuery<Contact> contactQuery =
        new ObjectQuery<Contact>(queryString, context);

    // Add parameters to the collection.
    contactQuery.Parameters.Add(new ObjectParameter("ln", "Adams"));
    contactQuery.Parameters.Add(new ObjectParameter("fn", "Frances"));

    ObjectParameterCollection objectParameterCollection =
        contactQuery.Parameters;

    Console.WriteLine("Count is {0}.", objectParameterCollection.Count);

    // Iterate through the ObjectParameterCollection collection.
    foreach (ObjectParameter result in objectParameterCollection)
    {
        Console.WriteLine("{0} {1} {2}", result.Name,
            result.Value,
            result.ParameterType);
    }
}

설명

매개 변수를 추가한 다음 쿼리를 컴파일하거나 실행하지 않았으면 컬렉션에서 매개 변수를 제거할 수도 있고 컬렉션을 지울 수도 있습니다. 매개 변수 이름은 변경할 수 없지만 값은 언제든지 변경할 수 있습니다.

매개 변수는 ObjectParameterCollection에서 고유해야 합니다. 컬렉션에 같은 이름의 매개 변수가 두 개 있을 수 없습니다. 자세한 내용은 쿼리 작성기 메서드합니다.

적용 대상

추가 정보