Teilen über

ObjectParameter Konstruktoren

  • Referenz

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

Gilt für:

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.

Gilt für: