ObjectParameterCollection.Add(ObjectParameter) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.