ObjectParameter Constructeurs

Définition

Espace de noms:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Initialise une nouvelle instance de la classe ObjectParameter.

Surcharges

Nom	Description
ObjectParameter(String, Object)	Initialise une nouvelle instance de la ObjectParameter classe avec le nom et la valeur spécifiés.
ObjectParameter(String, Type)	Initialise une nouvelle instance de la ObjectParameter classe avec le nom et le type spécifiés.

ObjectParameter(String, Object)

Initialise une nouvelle instance de la ObjectParameter classe avec le nom et la valeur spécifiés.

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)

Paramètres

name

String

Nom du paramètre. Ce nom ne doit pas inclure le marqueur de paramètre « @ » utilisé dans les instructions Entity SQL, uniquement le nom réel. Le premier caractère de l’expression doit être une lettre. Tous les caractères successifs de l’expression doivent être des lettres, des chiffres ou un caractère de trait de soulignement (_).

value

Object

Valeur initiale (et intrinsèquement, type) du paramètre.

Exceptions

ArgumentNullException

Si la valeur de l’un ou l’autre argument est Null.

ArgumentOutOfRangeException

Si la valeur de l’argument name n’est pas valide. Les noms de paramètres doivent commencer par une lettre et ne peuvent contenir que des lettres, des chiffres et des traits de soulignement.

Exemples

Cet exemple ajoute de nouveaux paramètres à la collection. Il effectue une itération au sein de la ObjectParameterCollection collection et affiche le nom, le type et la valeur de chaque paramètre de la collection.

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

Remarques

Ce constructeur crée un paramètre à partir du nom et de la valeur spécifiés. Le type du paramètre est déduit de la valeur.

Lorsqu’il est ajouté au paramètre, le nom du ObjectParameterCollectionparamètre ne peut pas être modifié. La valeur du paramètre peut être modifiée par le biais de la Value propriété. Une fois la requête compilée, la valeur ne peut pas être modifiée. Pour plus d’informations, consultez Méthodes du Générateur de requêtes.

Voir aussi

• Interrogation de données en tant qu’objets et mise en forme des résultats (Entity Framework)

ObjectParameter(String, Type)

Initialise une nouvelle instance de la ObjectParameter classe avec le nom et le type spécifiés.

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)

Paramètres

name

String

Nom du paramètre. Ce nom ne doit pas inclure le marqueur de paramètre « @ » utilisé dans les instructions Entity SQL, uniquement le nom réel. Le premier caractère de l’expression doit être une lettre. Tous les caractères successifs de l’expression doivent être des lettres, des chiffres ou un caractère de trait de soulignement (_).

type

Type

Type CLR (Common Language Runtime) du paramètre.

Exceptions

ArgumentNullException

Si la valeur de l’un ou l’autre argument est Null.

ArgumentOutOfRangeException

Si la valeur de l’argument name n’est pas valide. Les noms de paramètres doivent commencer par une lettre et ne peuvent contenir que des lettres, des chiffres et des traits de soulignement.

Remarques

En cas d’instanciation, le nom du paramètre ne peut pas être modifié. La valeur du paramètre peut être définie ou modifiée par le biais de la Value propriété. Une fois la requête compilée, la valeur ne peut pas être modifiée. Pour plus d’informations, consultez Méthodes du Générateur de requêtes.