Freigeben über

ObjectParameter Konstruktoren

Definition

Namespace:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Initialisiert eine neue Instanz der ObjectParameter-Klasse.

Überlädt

Name Beschreibung
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 Parametername. 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 nachfolgenden Zeichen im Ausdruck müssen Buchstaben, Zahlen oder ein Unterstrichzeichen (_) sein.

value
Object

Der Anfangswert (und der Typ) des Parameters.

Ausnahmen

ArgumentNullException

Wenn der Wert eines der argumente null ist.

ArgumentOutOfRangeException

Wenn der Wert des Namensarguments ungültig ist. Parameternamen müssen mit einem Buchstaben beginnen und dürfen nur Buchstaben, Zahlen und Unterstriche enthalten.

Beispiele

In diesem Beispiel werden der Auflistung neue Parameter hinzugefügt. Er durchläuft den ObjectParameterCollection Namen, den Typ und den Wert der einzelnen Parameter in der Auflistung und zeigt ihn an.

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 einen Parameter aus dem angegebenen Namen und Wert. Der Typ des Parameters wird vom Wert abgeleitet.

Wenn der ObjectParameterCollectionParametername hinzugefügt wird, kann der Parametername nicht geändert werden. Der Parameterwert kann über die Value Eigenschaft geändert werden. Nachdem die Abfrage kompiliert wurde, 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 Parametername. Dieser Name sollte nicht die Parametermarkierung "@" enthalten, die in den Entity SQL-Anweisungen verwendet wird, nur den tatsächlichen Namen. Das erste Zeichen des Ausdrucks muss ein Buchstabe sein. Alle nachfolgenden Zeichen im Ausdruck müssen Buchstaben, Zahlen oder ein Unterstrichzeichen (_) sein.

type
Type

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

Ausnahmen

ArgumentNullException

Wenn der Wert eines der argumente null ist.

ArgumentOutOfRangeException

Wenn der Wert des Namensarguments ungültig ist. Parameternamen müssen mit einem Buchstaben beginnen und dürfen nur Buchstaben, Zahlen und Unterstriche enthalten.

Hinweise

Beim Instanziieren kann der Parametername nicht geändert werden. Der Parameterwert kann über die Value Eigenschaft festgelegt oder geändert werden. Nachdem die Abfrage kompiliert wurde, kann der Wert nicht mehr geändert werden. Weitere Informationen finden Sie unter Abfrage-Generator-Methoden.

Gilt für: