ObjectParameterCollection.Add(ObjectParameter) Método

Definición

Agrega el ObjectParameter especificado a la colección.

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)

Parámetros

parameter
ObjectParameter

Parámetro que se va a agregar a la colección.

Implementaciones

Excepciones

El argumento parameter es null.

El argumento parameter ya existe en la colección. Este comportamiento es distinto del de la mayoría de las colecciones que permiten entradas duplicadas.

o bien

Ya existe en la colección otro parámetro con el mismo nombre que el argumento parameter. Observe que la búsqueda distingue entre mayúsculas y minúsculas. Este comportamiento es distinto del de la mayoría de las colecciones y se parece más al de un Dictionary<TKey,TValue>.

El tipo de parameter no es válido.

Ejemplos

En este ejemplo se agregan nuevos parámetros a la colección. Se recorre en iteración la ObjectParameterCollection y se muestra el nombre, el tipo y el valor de cada parámetro de la colección.

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);
    }
}

Comentarios

Una vez agregados, los parámetros se pueden quitar de la colección y ésta, a su vez, se puede borrar, siempre y cuando no se haya compilado ni ejecutado la consulta. No se pueden cambiar los nombres de los parámetros, pero sí se pueden cambiar sus valores en cualquier momento.

Los parámetros deben ser únicos en la ObjectParameterCollection. No puede haber dos parámetros en la colección con el mismo nombre. Para obtener más información, vea Métodos del Generador de consultas.

Se aplica a

Consulte también