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 objeto especificado ObjectParameter 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 parameter argumento es null.
El parameter argumento ya existe en la colección. Este comportamiento difiere del de la mayoría de las colecciones que permiten entradas duplicadas.
O bien
Otro parámetro con el mismo nombre que el parameter argumento ya existe en la colección. Tenga en cuenta que la búsqueda no distingue mayúsculas de minúsculas. Este comportamiento difiere del de la mayoría de las colecciones y es más parecido al de un Dictionary<TKey,TValue>.
El tipo de no parameter es válido.
Ejemplos
En este ejemplo se agregan nuevos parámetros a la colección. Recorre en ObjectParameterCollection iteración y 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 la colección se puede borrar, siempre que la consulta no se haya compilado o ejecutado. Los nombres de parámetro no se pueden cambiar, pero los valores se pueden cambiar en cualquier momento.
Los parámetros deben ser únicos en .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.