ObjectParameterCollection Klasa

Definicja

Reprezentuje parametry zapytania jako ObjectParameter obiekty, które są zdefiniowane ObjectQuery<T>w.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)
Dziedziczenie
ObjectParameterCollection
Implementuje

Przykłady

Przykład w tym temacie jest oparty na modelu sprzedaży AdventureWorks.The example in this topic is based on the AdventureWorks Sales Model. Przykład dodaje nowe parametry do kolekcji i pobiera liczbę parametrów w kolekcji.The example adds new parameters to the collection and gets the count of the parameters in the collection. Następnie wykonuje iterację przez ObjectParameterCollection i wyświetla nazwę, typ i wartość każdego parametru w kolekcji.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

Uwagi

Reprezentuje parametry zapytania jako ObjectParameter obiekty zdefiniowane ObjectQuery<T>w.Represents the query parameters as ObjectParameter objects defined in an ObjectQuery<T>.

Klasa ta nie może być dziedziczona.This class cannot be inherited.

Parametry, które są przesyłane do metod konstruktora zapytań są agregowane przez kolejne wystąpienia ObjectQuery<T> sekwencji.The parameters that are passed to query builder methods are aggregated by successive instances of an ObjectQuery<T> in the sequence. Dostęp do nich można uzyskać za pomocą Parameters właściwości, która ObjectParameterCollectionzwraca.They can be accessed by using the Parameters property, which returns the ObjectParameterCollection. Po dodaniu parametrów można je usunąć z kolekcji, a kolekcja może zostać wyczyszczona, o ile zapytanie nie zostało skompilowane lub wykonane.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. Nie można zmienić nazw parametrów, ale wartości można zmienić w dowolnym momencie.Parameter names cannot be changed, but values can be changed at any time.

Parametry muszą być unikatowe w ObjectParameterCollection.Parameters must be unique in the ObjectParameterCollection. Kolekcja nie może mieć dwóch parametrów o tej samej nazwie.There cannot be two parameters in the collection with the same name.

W przypadku używania metod kompozycji, takich Unionjak UnionAll, Intersect , Excepti, parametry są scalane.When using composition methods, such as Union, UnionAll, Intersect and Except, the parameters are merged. Wyjątek jest zgłaszany, gdy zestawy parametrów są niezgodne lub niekompletne.An exception is thrown when the sets of parameters are incompatible or incomplete. Aby uzyskać więcej informacji, zobacz Konstruktor zapytań metod.For more information, see Query Builder Methods.

Właściwości

Count

Pobiera liczbę parametrów znajdujących się obecnie w kolekcji.Gets the number of parameters currently in the collection.

Item[String]

Udostępnia indeksator, który umożliwia wywołujący pobieranie parametrów według nazwy.Provides an indexer that allows callers to retrieve parameters by name.

Metody

Add(ObjectParameter)

Dodaje określony ObjectParameter do kolekcji.Adds the specified ObjectParameter to the collection.

Clear()

Usuwa wszystkie ObjectParameter wystąpienia z kolekcji.Deletes all ObjectParameter instances from the collection.

Contains(ObjectParameter)

Sprawdza obecność określonego ObjectParameter w kolekcji przez odwołanie.Checks for the existence of a specified ObjectParameter in the collection by reference.

Contains(String)

Określa, czy ObjectParameter z określoną nazwą znajduje się w kolekcji.Determines whether an ObjectParameter with the specified name is in the collection.

CopyTo(ObjectParameter[], Int32)

Umożliwia skopiowanie parametrów w kolekcji do dostarczonej tablicy, rozpoczynając od obiektu pod określonym indeksem.Allows the parameters in the collection to be copied into a supplied array, starting with the object at the specified index.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(ObjectParameter)

Usuwa wystąpienie elementu ObjectParameter z kolekcji przez odwołanie, jeśli istnieje w kolekcji.Removes an instance of an ObjectParameter from the collection by reference if it exists in the collection.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection<ObjectParameter>.IsReadOnly

Pobiera wartość wskazującą, czy kolekcja jest tylko do odczytu czy może być modyfikowana.Gets a value that indicates whether the collection is read-only or can be modified.

IEnumerable.GetEnumerator()

Zwraca moduł wyliczający nietypu w kolekcji.Returns an untyped enumerator over the collection.

IEnumerable<ObjectParameter>.GetEnumerator()

Zwraca moduł wyliczający o określonym typie w kolekcji.Returns a typed enumerator over the collection.

Metody rozszerzania

CopyToDataTable<T>(IEnumerable<T>)

Zwraca DataTable, który zawiera kopie obiektów DataRow, przy użyciu obiektu wejściowego IEnumerable<T>, gdzie T parametru generycznego jest 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)

Kopiuje DataRow obiektów do określonego DataTable, używając obiektu wejściowego IEnumerable<T>, gdzie T parametru generycznego jest 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)

Kopiuje DataRow obiektów do określonego DataTable, używając obiektu wejściowego IEnumerable<T>, gdzie T parametru generycznego jest DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable na IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Zwraca kolekcję elementów, które zawierają elementy nadrzędne każdego węzła w kolekcji źródłowej.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Zwraca przefiltrowany kolekcji elementów, które zawierają elementy nadrzędne każdego węzła w kolekcji źródłowej.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Kolekcja zawiera tylko elementy, które mają pasujące XName.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Zwraca kolekcję węzłów podrzędnych każdego dokumentu i elementu w kolekcji źródłowej.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Zwraca kolekcję elementów, które zawierają elementy podrzędne każdego elementu i dokumentu w kolekcji źródłowej.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Zwraca przefiltrowany kolekcji elementów, które zawierają elementy podrzędne każdego elementu i dokumentu w kolekcji źródłowej.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Kolekcja zawiera tylko elementy, które mają pasujące XName.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Zwraca kolekcję elementów podrzędnych każdego elementu i dokumentu w kolekcji źródłowej.Returns a collection of the child elements of every element and document in the source collection.

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

Zwraca filtrowaną kolekcję elementów podrzędnych każdego elementu i dokumentu w kolekcji źródłowej.Returns a filtered collection of the child elements of every element and document in the source collection. Kolekcja zawiera tylko elementy, które mają pasujące XName.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Zwraca kolekcję węzłów, która zawiera wszystkie węzły w kolekcji źródłowej, posortowane w kolejności dokumentu.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Zwraca kolekcję węzłów podrzędnych każdego dokumentu i elementu w kolekcji źródłowej.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Usuwa każdy węzeł w kolekcji źródłowej z węzła nadrzędnego.Removes every node in the source collection from its parent node.

Dotyczy

Zobacz też