Partilhar via


ObjectParameter Construtores

Definição

Inicializa uma nova instância da classe ObjectParameter.

Sobrecargas

ObjectParameter(String, Object)

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

ObjectParameter(String, Type)

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

ObjectParameter(String, Object)

Inicializa uma nova instância da classe ObjectParameter 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. Esse nome não deve incluir o marcador de parâmetro "@" usado em instruções Entity SQL, apenas o nome real. O primeiro caractere da expressão deve ser uma letra. Quaisquer caracteres sucessivos na expressão devem ser letras, números ou um caractere de sublinhado (_).

value
Object

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

Exceções

Se o valor de um dos argumentos for nulo.

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

Exemplos

Este exemplo adiciona novos parâmetros à coleção. Ele itera pelo ObjectParameterCollection e exibe 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);
    }
}

Comentários

Esse construtor cria um parâmetro com base no nome e no valor especificados. O tipo do parâmetro é inferido do valor.

Quando adicionado ao , o nome do ObjectParameterCollectionparâmetro não pode ser alterado. O valor do parâmetro pode ser alterado por meio da Value propriedade . Depois que a consulta tiver sido compilada, o valor não poderá ser alterado. Para obter mais informações, consulte Métodos do Construtor de Consultas.

Confira também

Aplica-se a

ObjectParameter(String, Type)

Inicializa uma nova instância da classe ObjectParameter com o nome e o 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. Esse nome não deve incluir o marcador de parâmetro "@" que é usado em instruções Entity SQL, apenas o nome real. O primeiro caractere da expressão deve ser uma letra. Quaisquer caracteres sucessivos na expressão devem ser letras, números ou um caractere de sublinhado (_).

type
Type

O tipo CLR (Common Language Runtime) do parâmetro.

Exceções

Se o valor de um dos argumentos for nulo.

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

Comentários

Quando instanciado, o nome do parâmetro não pode ser alterado. O valor do parâmetro pode ser definido ou alterado por meio da Value propriedade . Depois que a consulta tiver sido compilada, o valor não poderá ser alterado. Para obter mais informações, consulte Métodos do Construtor de Consultas.

Aplica-se a