ObjectParameter Costruttori

Definizione

Spazio dei nomi:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Inizializza una nuova istanza della classe ObjectParameter.

Overload

ObjectParameter(String, Object)	Inizializza una nuova istanza della classe ObjectParameter con il nome e il valore specificati.
ObjectParameter(String, Type)	Inizializza una nuova istanza della classe ObjectParameter con il nome e il tipo specificati.

ObjectParameter(String, Object)

Inizializza una nuova istanza della classe ObjectParameter con il nome e il valore specificati.

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)

Parametri

name

String

Nome del parametro. Questo nome non deve includere il marcatore di parametro "@" usato nelle istruzioni Entity SQL, ma solo il nome effettivo. Il primo carattere dell'espressione deve essere una lettera. Tutti i caratteri successivi nell'espressione devono essere lettere, numeri o un carattere di sottolineatura (_).

value

Object

Valore iniziale, e implicitamente il tipo, del parametro.

Eccezioni

ArgumentNullException

Se il valore di un argomento è null.

ArgumentOutOfRangeException

Se il valore dell'argomento nome non è valido. I nomi dei parametri devono iniziare con una lettera e possono contenere solo lettere, numeri e caratteri di sottolineatura.

Esempio

In questo esempio vengono aggiunti nuovi parametri alla raccolta. Viene scorso l'oggetto ObjectParameterCollection e vengono visualizzati il nome, il tipo e il valore di ogni parametro nella raccolta.

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

Commenti

Questo costruttore crea un parametro dal nome e dal valore specificati. Il tipo del parametro viene dedotto dal valore.

Dopo avere aggiunto il parametro all'oggetto ObjectParameterCollection, il nome del parametro non può essere modificato. Il valore del parametro può essere modificato tramite la proprietà Value. Dopo la compilazione della query, il valore non può essere modificato. Per altre informazioni, vedere Metodi del generatore di query.

Vedi anche

• Esecuzione di query sui dati come oggetti e data shaping (Entity Framework)

ObjectParameter(String, Type)

Inizializza una nuova istanza della classe ObjectParameter con il nome e il tipo specificati.

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)

Parametri

name

String

Nome del parametro. Questo nome non deve includere il marcatore di parametro "@" usato nelle istruzioni Entity SQL, ma solo il nome effettivo. Il primo carattere dell'espressione deve essere una lettera. Tutti i caratteri successivi nell'espressione devono essere lettere, numeri o un carattere di sottolineatura (_).

type

Type

Tipo Common Language Runtime (CLR) del parametro.

Eccezioni

ArgumentNullException

Se il valore di un argomento è null.

ArgumentOutOfRangeException

Se il valore dell'argomento nome non è valido. I nomi dei parametri devono iniziare con una lettera e possono contenere solo lettere, numeri e caratteri di sottolineatura.

Commenti

Dopo avere creato un'istanza del parametro, il nome del parametro non può essere modificato. Il valore del parametro può essere impostato o modificato tramite la proprietà Value. Dopo la compilazione della query, il valore non può essere modificato. Per altre informazioni, vedere Metodi del generatore di query.