ObjectParameterCollection ObjectParameterCollection ObjectParameterCollection ObjectParameterCollection Class

Definizione

Rappresenta i parametri di query come oggetti ObjectParameter definiti in un oggetto 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)
Ereditarietà
ObjectParameterCollectionObjectParameterCollectionObjectParameterCollectionObjectParameterCollection
Implementazioni

Esempi

L'esempio in questo argomento si basa sul modello Sales di AdventureWorks.The example in this topic is based on the AdventureWorks Sales Model. Nell'esempio vengono aggiunti nuovi parametri alla raccolta e viene ottenuto il numero di parametri presenti nella raccolta.The example adds new parameters to the collection and gets the count of the parameters in the collection. Viene quindi scorso l'oggetto ObjectParameterCollection e vengono visualizzati il nome, il tipo e il valore di ogni parametro nella raccolta.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

Commenti

Rappresenta i parametri di query come oggetti ObjectParameter definiti in un oggetto ObjectQuery<T>.Represents the query parameters as ObjectParameter objects defined in an ObjectQuery<T>.

Questa classe non può essere ereditata.This class cannot be inherited.

I parametri passati ai metodi del generatore di query vengono aggregati dalle istanze successive di un oggetto ObjectQuery<T> nella sequenza.The parameters that are passed to query builder methods are aggregated by successive instances of an ObjectQuery<T> in the sequence. È possibile accedervi utilizzando la proprietà Parameters, che restituisce l'oggetto ObjectParameterCollection.They can be accessed by using the Parameters property, which returns the ObjectParameterCollection. Dopo essere stati aggiunti, i parametri possono essere rimossi dalla raccolta e la raccolta può essere cancellata, a condizione che la query non sia stata compilata o eseguita.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. I nomi dei parametri non possono essere modificati, ma è possibile cambiare i valori in qualsiasi momento.Parameter names cannot be changed, but values can be changed at any time.

I parametri devono essere univoci in ObjectParameterCollection.Parameters must be unique in the ObjectParameterCollection. Nella raccolta non possono essere presenti due parametri con lo stesso nome.There cannot be two parameters in the collection with the same name.

Quando si utilizzano i metodi di composizione, ad esempio Union, UnionAll, Intersect e Except, i parametri vengono uniti.When using composition methods, such as Union, UnionAll, Intersect and Except, the parameters are merged. Quando i set di parametri sono incompatibili o incompleti, viene generata un'eccezione.An exception is thrown when the sets of parameters are incompatible or incomplete. Per altre informazioni, vedere metodi del generatore di Query.For more information, see Query Builder Methods.

Proprietà

Count Count Count Count

Ottiene il numero di parametri attualmente presenti nella raccolta.Gets the number of parameters currently in the collection.

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

Fornisce un indicizzatore che consente ai chiamanti di recuperare i parametri in base al nome.Provides an indexer that allows callers to retrieve parameters by name.

Metodi

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

Aggiunge l'oggetto ObjectParameter specificato alla raccolta.Adds the specified ObjectParameter to the collection.

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

Elimina tutte le istanze di ObjectParameter dalla raccolta.Deletes all ObjectParameter instances from the collection.

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

Verifica se nella raccolta è presente un oggetto ObjectParameter specificato in base al riferimento.Checks for the existence of a specified ObjectParameter in the collection by reference.

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

Determina se un oggetto ObjectParameter con il nome specificato è presente nella raccolta.Determines whether an ObjectParameter with the specified name is in the collection.

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

Consente di copiare i parametri presenti nella raccolta in una matrice specificata, partendo dall'oggetto in corrispondenza dell'indice specificato.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)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Rimuove un'istanza di un oggetto ObjectParameter dalla raccolta in base al riferimento se presente nella raccolta.Removes an instance of an ObjectParameter from the collection by reference if it exists in the collection.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Ottiene un valore che indica se la raccolta è di sola lettura o se può essere modificato.Gets a value that indicates whether the collection is read-only or can be modified.

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

Restituisce un enumeratore non tipizzato della raccolta.Returns an untyped enumerator over the collection.

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

Restituisce un enumeratore tipizzato della raccolta.Returns a typed enumerator over the collection.

Extension Methods

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

Restituisce un DataTable che contiene copie del DataRow oggetti, dato un input IEnumerable<T> oggetto in cui il parametro generico 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)

Le copie DataRow oggetti specificata DataTable, un giudizio IEnumerable<T> oggetto in cui il parametro generico 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)

Le copie DataRow oggetti specificata DataTable, un giudizio IEnumerable<T> oggetto in cui il parametro generico 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)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

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

Consente la parallelizzazione di una query.Enables parallelization of a query.

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

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

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

Restituisce una raccolta di elementi che contiene i predecessori di ciascun nodo nella raccolta di origine.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)

Restituisce una raccolta di elementi filtrati che contiene i predecessori di ciascun nodo nella raccolta di origine.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.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>)

Restituisce una raccolta di nodi discendenti di ciascun documento ed elemento nella raccolta di origine.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>)

Restituisce una raccolta di elementi che contiene gli elementi discendenti di ciascun elemento e documento nella raccolta di origine.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)

Restituisce una raccolta filtrata di elementi che contiene gli elementi discendenti di ciascun elemento e documento nella raccolta di origine.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.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>)

Restituisce una raccolta di elementi figlio di ciascun elemento e documento nella raccolta di origine.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)

Restituisce una raccolta filtrata degli elementi figlio di ciascun elemento e documento nella raccolta di origine.Returns a filtered collection of the child elements of every element and document in the source collection. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.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>)

Restituisce una raccolta di nodi che contiene tutti i nodi nella raccolta di origine ordinati in base all'ordine con cui sono riportati nel documento.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>)

Restituisce una raccolta di nodi figlio di ciascun documento ed elemento nella raccolta di origine.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>)

Rimuove ciascun nodo nella raccolta di origine dal nodo padre.Removes every node in the source collection from its parent node.

Si applica a

Vedi anche