ObjectParameter Construtores

Definição

Espaço de Nomes:
System.Data.Objects
Assemblagem:
System.Data.Entity.dll

Inicializa uma nova instância da ObjectParameter classe.

Sobrecargas

Name Description
ObjectParameter(String, Object)

Inicializa uma nova instância da ObjectParameter classe com o nome e valor especificados.
ObjectParameter(String, Type)

Inicializa uma nova instância da ObjectParameter classe com o nome e tipo especificados.

ObjectParameter(String, Object)

Inicializa uma nova instância da ObjectParameter classe com o nome e valor especificados.

public:
 ObjectParameter(System::String ^ name, System::Object ^ value);
public ObjectParameter(string name, object value);
new System.Data.Objects.ObjectParameter : string * obj -> System.Data.Objects.ObjectParameter
Public Sub New (name As String, value As Object)

Parâmetros

name
String

O nome do parâmetro. Este nome não deve incluir o marcador do parâmetro "@" usado nas instruções SQL da Entidade, apenas o nome real. O primeiro carácter da expressão deve ser uma letra. Quaisquer caracteres sucessivos na expressão devem ser letras, números ou um sublinhado (_).

value
Object

O valor inicial (e, intrinsecamente, o tipo) do parâmetro.

Exceções

ArgumentNullException

Se o valor de qualquer um dos argumentos for nulo.

ArgumentOutOfRangeException

Se o valor do argumento do nome não for válido. Os nomes dos parâmetros devem começar por uma letra e só podem conter letras, números e sublinhas.

Exemplos

Este exemplo adiciona novos parâmetros à coleção. Itera através do ObjectParameterCollection e apresenta o nome, o tipo e o valor de cada parâmetro na coleção.

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;

    // Iterate through the ObjectParameterCollection.
    foreach (ObjectParameter result in objectParameterCollection)
    {
        Console.WriteLine("{0} {1} {2}", result.Name,
            result.Value,
            result.ParameterType);
    }
}

Observações

Este construtor cria um parâmetro a partir do nome e valor especificados. O tipo do parâmetro é inferido a partir do valor.

Quando adicionado ao ObjectParameterCollection, o nome do parâmetro não pode ser alterado. O valor do parâmetro pode ser alterado através da Value propriedade. Depois de compilada a consulta, o valor não pode ser alterado. Para mais informações, consulte Métodos do Construtor de Consultas.

Ver também

Aplica-se a

ObjectParameter(String, Type)

Inicializa uma nova instância da ObjectParameter classe com o nome e tipo especificados.

public:
 ObjectParameter(System::String ^ name, Type ^ type);
public ObjectParameter(string name, Type type);
new System.Data.Objects.ObjectParameter : string * Type -> System.Data.Objects.ObjectParameter
Public Sub New (name As String, type As Type)

Parâmetros

name
String

O nome do parâmetro. Este nome não deve incluir o marcador do parâmetro "@" usado nas instruções SQL da Entidade, apenas o nome real. O primeiro carácter da expressão deve ser uma letra. Quaisquer caracteres sucessivos na expressão devem ser letras, números ou um sublinhado (_).

type
Type

O tipo de runtime de linguagem comum (CLR) do parâmetro.

Exceções

ArgumentNullException

Se o valor de qualquer um dos argumentos for nulo.

ArgumentOutOfRangeException

Se o valor do argumento do nome for inválido. Os nomes dos parâmetros devem começar por uma letra e só podem conter letras, números e sublinhas.

Observações

Quando instanciado, o nome do parâmetro não pode ser alterado. O valor do parâmetro pode ser definido ou alterado através da Value propriedade. Depois de compilada a consulta, o valor não pode ser alterado. Para mais informações, consulte Métodos do Construtor de Consultas.

Aplica-se a