ObjectParameter Konstruktoren

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Initialisiert eine neue Instanz der ObjectParameter-Klasse.

Überlädt

ObjectParameter(String, Object)	Initialisiert eine neue Instanz der ObjectParameter-Klasse mit dem angegebenen Namen und Wert.
ObjectParameter(String, Type)	Initialisiert eine neue Instanz der ObjectParameter-Klasse mit dem angegebenen Namen und Typ.

ObjectParameter(String, Object)

Initialisiert eine neue Instanz der ObjectParameter-Klasse mit dem angegebenen Namen und Wert.

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)

Parameter

name

String

Der Name des Parameters. Dieser Name sollte nicht den Parametermarker "@" enthalten, der in Entity SQL-Anweisungen verwendet wird, nur den tatsächlichen Namen. Das erste Zeichen des Ausdrucks muss ein Buchstabe sein. Alle folgenden Zeichen im Ausdruck müssen Buchstaben, Zahlen oder Unterstriche (_) sein.

value

Object

Der Anfangswert (und dementsprechend der Typ) des Parameters.

Ausnahmen

ArgumentNullException

Wenn der Wert eines Arguments NULL ist.

ArgumentOutOfRangeException

Wenn der Wert des name-Arguments ungültig ist. Parameternamen müssen mit einem Buchstaben beginnen und können nur Buchstaben, Zahlen und Unterstriche enthalten.

Beispiele

In diesem Beispiel werden der Auflistung neue Parameter hinzugefügt. Die ObjectParameterCollection wird durchlaufen, und für jeden Parameter in der Auflistung werden Name, Typ und Wert angezeigt.

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

Hinweise

Dieser Konstruktor erstellt aus dem angegebenen Namen und Wert einen Parameter. Der Typ des Parameters wird aus dem Wert hergeleitet.

Nach dem Hinzufügen zur ObjectParameterCollection kann der Parametername nicht mehr geändert werden. Der Parameterwert kann über die Value-Eigenschaft geändert werden. Nach dem Kompilieren der Abfrage kann der Wert nicht mehr geändert werden. Weitere Informationen finden Sie unter Abfrage-Generator-Methoden.

Weitere Informationen

• Abfragen von Daten als Objekte und Strukturieren von Ergebnissen (Entity Framework)

ObjectParameter(String, Type)

Initialisiert eine neue Instanz der ObjectParameter-Klasse mit dem angegebenen Namen und Typ.

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)

Parameter

name

String

Der Name des Parameters. Dieser Name sollte nur den tatsächlichen Namen und nicht die Parametermarkierung „@“ enthalten, die in den Entity SQL-Anweisungen verwendet wird. Das erste Zeichen des Ausdrucks muss ein Buchstabe sein. Alle folgenden Zeichen im Ausdruck müssen Buchstaben, Zahlen oder Unterstriche (_) sein.

type

Type

Der CLR-Typ (Common Language Runtime) des Parameters.

Ausnahmen

ArgumentNullException

Wenn der Wert eines Arguments NULL ist.

ArgumentOutOfRangeException

Wenn der Wert des name-Arguments ungültig ist. Parameternamen müssen mit einem Buchstaben beginnen und können nur Buchstaben, Zahlen und Unterstriche enthalten.

Hinweise

Nach dem Instanziieren kann der Parametername nicht mehr geändert werden. Der Parameterwert kann über die Value-Eigenschaft festgelegt oder geändert werden. Nach dem Kompilieren der Abfrage kann der Wert nicht mehr geändert werden. Weitere Informationen finden Sie unter Abfrage-Generator-Methoden.