ObjectParameter Constructeurs

Définition

Espace de noms:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Initialise une nouvelle instance de la classe ObjectParameter.

Surcharges

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

ObjectParameter(String, Object)

Initialise une nouvelle instance de la classe ObjectParameter avec la valeur et le nom 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

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

value

Object

Valeur initiale (et, de manière inhérente, le type) du paramètre.

Exceptions

ArgumentNullException

Si la valeur de l’un des arguments est null.

ArgumentOutOfRangeException

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

Exemples

Cet exemple ajoute de nouveaux paramètres à la collection. Il itère au sein de la collection ObjectParameterCollection 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 à partir de la valeur.

Lorsqu'il est ajouté à l'objet ObjectParameterCollection, le nom du paramètre ne peut pas être modifié. La valeur du paramètre peut être modifiée par le biais de la propriété Value. 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 classe ObjectParameter 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

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

type

Type

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

Exceptions

ArgumentNullException

Si la valeur de l’un des arguments est null.

ArgumentOutOfRangeException

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

Remarques

Lorsqu'il est instancié, 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 propriété Value. 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.