ObjectParameterCollection ObjectParameterCollection ObjectParameterCollection ObjectParameterCollection Class

정의

쿼리 매개 변수를 ObjectParameter에 정의된 ObjectQuery<T> 개체로 나타냅니다.Represents the query parameters as ObjectParameter objects that are defined in an ObjectQuery<T>.

public ref class ObjectParameterCollection sealed : System::Collections::Generic::ICollection<System::Data::Objects::ObjectParameter ^>, System::Collections::Generic::IEnumerable<System::Data::Objects::ObjectParameter ^>
public sealed class ObjectParameterCollection : System.Collections.Generic.ICollection<System.Data.Objects.ObjectParameter>, System.Collections.Generic.IEnumerable<System.Data.Objects.ObjectParameter>
type ObjectParameterCollection = class
    interface ICollection<ObjectParameter>
    interface seq<ObjectParameter>
    interface IEnumerable
Public NotInheritable Class ObjectParameterCollection
Implements ICollection(Of ObjectParameter), IEnumerable(Of ObjectParameter)
상속
ObjectParameterCollectionObjectParameterCollectionObjectParameterCollectionObjectParameterCollection
구현

예제

이 항목의 예제는 기준으로 합니다 AdventureWorks Sales 모델합니다.The example in this topic is based on the AdventureWorks Sales Model. 예제에서는 새 매개 변수를 컬렉션에 추가하고 컬렉션에 있는 매개 변수의 수를 가져옵니다.The example adds new parameters to the collection and gets the count of the parameters in the collection. @FSHO2@그런 다음 ObjectParameterCollection을 반복하여 컬렉션에 있는 각 매개 변수의 이름, 형식 및 값을 표시합니다.Then it iterates through the ObjectParameterCollection and displays the name, type, and value of each parameter in the collection.

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);
    }
}
Using context As New AdventureWorksEntities()
    Dim queryString As String = "SELECT VALUE contact FROM AdventureWorksEntities.Contacts " & _
            " AS contact WHERE contact.LastName = @ln AND contact.FirstName = @fn"

    Dim contactQuery As New ObjectQuery(Of Contact)(queryString, context)

    ' Add parameters to the collection. 
    contactQuery.Parameters.Add(New ObjectParameter("ln", "Adams"))
    contactQuery.Parameters.Add(New ObjectParameter("fn", "Frances"))

    Dim objectParameterCollection As ObjectParameterCollection = contactQuery.Parameters

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

    ' Iterate through the ObjectParameterCollection collection. 
    For Each result As ObjectParameter In objectParameterCollection
        Console.WriteLine("{0} {1} {2}", result.Name, result.Value, result.ParameterType)
    Next
End Using

설명

쿼리 매개 변수를 ObjectParameter에 정의된 ObjectQuery<T> 개체로 나타냅니다.Represents the query parameters as ObjectParameter objects defined in an ObjectQuery<T>.

이 클래스는 상속될 수 없습니다.This class cannot be inherited.

쿼리 작성기 메서드에 전달되는 매개 변수는 시퀀스에서 ObjectQuery<T>의 후속 인스턴스에 의해 집계되며,The parameters that are passed to query builder methods are aggregated by successive instances of an ObjectQuery<T> in the sequence. Parameters을 반환하는 ObjectParameterCollection 속성을 사용하여 액세스할 수 있습니다.They can be accessed by using the Parameters property, which returns the ObjectParameterCollection. 매개 변수를 추가한 다음 쿼리를 컴파일하거나 실행하지 않았으면 컬렉션에서 매개 변수를 제거할 수도 있고 컬렉션을 지울 수도 있습니다.After parameters have been added, they can be removed from the collection and the collection can be cleared, as long as the query has not been compiled or executed. 매개 변수 이름은 변경할 수 없지만 값은 언제든지 변경할 수 있습니다.Parameter names cannot be changed, but values can be changed at any time.

매개 변수는 ObjectParameterCollection에서 고유해야 합니다.Parameters must be unique in the ObjectParameterCollection. 컬렉션에 같은 이름의 매개 변수가 두 개 있을 수 없습니다.There cannot be two parameters in the collection with the same name.

Union, UnionAll, Intersect, Except 등의 구성 메서드를 사용할 때 매개 변수가 병합됩니다.When using composition methods, such as Union, UnionAll, Intersect and Except, the parameters are merged. 매개 변수 집합이 호환되지 않거나 완전하지 않으면 예외가 throw됩니다.An exception is thrown when the sets of parameters are incompatible or incomplete. 자세한 내용은 쿼리 작성기 메서드합니다.For more information, see Query Builder Methods.

속성

Count Count Count Count

현재 컬렉션에 있는 매개 변수의 수를 가져옵니다.Gets the number of parameters currently in the collection.

Item[String] Item[String] Item[String] Item[String]

호출자가 이름으로 매개 변수를 검색할 수 있는 인덱서를 제공합니다.Provides an indexer that allows callers to retrieve parameters by name.

메서드

Add(ObjectParameter) Add(ObjectParameter) Add(ObjectParameter) Add(ObjectParameter)

지정된 ObjectParameter를 컬렉션에 추가합니다.Adds the specified ObjectParameter to the collection.

Clear() Clear() Clear() Clear()

컬렉션에서 ObjectParameter 인스턴스를 모두 삭제합니다.Deletes all ObjectParameter instances from the collection.

Contains(ObjectParameter) Contains(ObjectParameter) Contains(ObjectParameter) Contains(ObjectParameter)

지정한 ObjectParameter가 컬렉션에 있는지 참조를 통해 확인합니다.Checks for the existence of a specified ObjectParameter in the collection by reference.

Contains(String) Contains(String) Contains(String) Contains(String)

지정한 이름의 ObjectParameter가 컬렉션에 있는지 여부를 확인합니다.Determines whether an ObjectParameter with the specified name is in the collection.

CopyTo(ObjectParameter[], Int32) CopyTo(ObjectParameter[], Int32) CopyTo(ObjectParameter[], Int32) CopyTo(ObjectParameter[], Int32)

지정된 인덱스의 개체부터 시작하여 컬렉션의 매개 변수를 제공된 배열에 복사할 수 있습니다.Allows the parameters in the collection to be copied into a supplied array, starting with the object at the specified index.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Remove(ObjectParameter) Remove(ObjectParameter) Remove(ObjectParameter) Remove(ObjectParameter)

ObjectParameter 인스턴스가 컬렉션에 있으면 참조를 통해 컬렉션에서 제거합니다.Removes an instance of an ObjectParameter from the collection by reference if it exists in the collection.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

명시적 인터페이스 구현

ICollection<ObjectParameter>.IsReadOnly ICollection<ObjectParameter>.IsReadOnly ICollection<ObjectParameter>.IsReadOnly ICollection<ObjectParameter>.IsReadOnly

컬렉션이 읽기 전용인지 또는 수정할 수 있는지를 나타내는 값을 가져옵니다.Gets a value that indicates whether the collection is read-only or can be modified.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

컬렉션에서 형식화되지 않은 열거자를 반환합니다.Returns an untyped enumerator over the collection.

IEnumerable<ObjectParameter>.GetEnumerator() IEnumerable<ObjectParameter>.GetEnumerator() IEnumerable<ObjectParameter>.GetEnumerator() IEnumerable<ObjectParameter>.GetEnumerator()

컬렉션에서 형식화된 열거자를 반환합니다.Returns a typed enumerator over the collection.

확장 메서드

CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>)

제네릭 매개 변수 TDataTable인 지정된 입력 DataRow 개체를 사용하여 IEnumerable<T> 개체의 복사본이 들어 있는 DataRow을 반환합니다.Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

제네릭 매개 변수 TDataRow인 지정된 입력 DataTable 개체를 사용하여 IEnumerable<T> 개체를 지정된 DataRow에 복사합니다.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

제네릭 매개 변수 TDataRow인 지정된 입력 DataTable 개체를 사용하여 IEnumerable<T> 개체를 지정된 DataRow에 복사합니다.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

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

Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 노드의 상위 항목이 들어 있는 요소 컬렉션을 반환합니다.Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName)

소스 컬렉션에 있는 모든 노드의 상위 항목이 들어 있는 필터링된 요소 컬렉션을 반환합니다.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. 일치하는 XName이 있는 요소만 컬렉션에 포함됩니다.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 문서 및 요소의 하위 노드 컬렉션을 반환합니다.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 요소 및 문서의 하위 요소가 들어 있는 요소 컬렉션을 반환합니다.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName)

소스 컬렉션에 있는 모든 요소 및 문서의 하위 요소가 들어 있는 필터링된 요소 컬렉션을 반환합니다.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. 일치하는 XName이 있는 요소만 컬렉션에 포함됩니다.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 요소 및 문서의 자식 요소 컬렉션을 반환합니다.Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName)

소스 컬렉션에 있는 모든 요소 및 문서의 필터링된 자식 요소 컬렉션을 반환합니다.Returns a filtered collection of the child elements of every element and document in the source collection. 일치하는 XName이 있는 요소만 컬렉션에 포함됩니다.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>)

소스 컬렉션의 모든 노드가 문서 순으로 정렬되어 들어 있는 노드 컬렉션을 반환합니다.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 문서 및 요소의 자식 노드 컬렉션을 반환합니다.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>)

부모 노드에서 소스 컬렉션의 모든 노드를 제거합니다.Removes every node in the source collection from its parent node.

적용 대상

추가 정보