ObjectParameterCollection.Add(ObjectParameter) 메서드

정의

네임스페이스:
System.Data.Objects
어셈블리:
System.Data.Entity.dll

컬렉션에 지정된 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

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

구현

Add(T)

예외

ArgumentNullException

인수는 parameter .입니다 null.

ArgumentException

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

-또는-

인수와 이름이 같은 다른 매개 변수가 parameter 컬렉션에 이미 있습니다. 조회는 대/소문자를 구분하지 않습니다. 이 동작은 대부분의 컬렉션과 다르며 Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

형식이 parameter 잘못되었습니다.

예제

다음은 컬렉션에 새 매개 변수를 추가하는 예제입니다. 컬렉션에서 각 매개 변수의 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고유해야 합니다. 컬렉션에는 이름이 같은 두 개의 매개 변수가 있을 수 없습니다. 자세한 내용은 쿼리 작성기 메서드를 참조하세요.

적용 대상

추가 정보