Parameter-Element (CSDL)
Das Parameter-Element in konzeptioneller Schemadefinitionssprache (CSDL) kann ein untergeordnetes Element des FunctionImport-Elements oder des Function-Elements sein.
FunctionImport-Element-Anwendung
Ein Parameter-Element (als untergeordnetes Element des FunctionImport-Elements) wird verwendet, um Eingabe- und Ausgabeparameter für Funktionsimporte zu definieren, die in CSDL deklariert werden.
Das Parameter-Element kann die folgenden untergeordneten Elemente aufweisen (der vorliegenden Reihenfolge entsprechend):
Dokumentation (kein (null oder ein Element zugelassen)
Anmerkungselemente (kein (null) Element oder mehrere Elemente zugelassen)
Anwendbare Attribute
In der folgenden Tabelle werden die Attribute beschrieben, die für das Parameter-Element übernommen werden können.
Attributname |
Ist erforderlich |
Value |
|---|---|---|
Name |
Ja |
Der Name des Parameters. |
Type |
Ja |
Der Typ des Parameters.Der Wert muss ein EDMSimpleType oder ein komplexer Typ sein, der sich innerhalb des Bereichs des Modells befindet.Weitere Informationen finden Sie unter Konzeptionelle Modelltypen (CSDL). |
Mode |
Nein |
Die Verwendung von In, Out oder InOut ist abhängig davon, ob der Parameter ein Eingabe-, Ausgabe- oder Eingabe/Ausgabeparameter ist. |
MaxLength |
Nein |
Die maximal zulässige Länge des Parameters. |
Precision |
Nein |
Die Genauigkeit des Parameters. |
Scale |
Nein |
Die Skalierung des Parameters. |
Hinweis
Eine beliebige Anzahl von Anmerkungsattributen (benutzerdefinierte XML-Attribute) kann für das Parameter-Element übernommen werden.Benutzerdefinierte Attribute dürfen jedoch zu keinem XML-Namespace gehören, der für CSDL reserviert ist.Die vollqualifizierten Namen für zwei benutzerdefinierte Attribute dürfen nicht übereinstimmen.
Beispiel
Im folgenden Beispiel wird ein FunctionImport-Element mit einem untergeordneten Parameter-Element dargestellt.Die Funktion akzeptiert einen Eingabeparameter und gibt eine Auflistung von Entitätstypen zurück.
<FunctionImport Name="GetStudentGrades"
EntitySet="StudentGrade"
ReturnType="Collection(SchoolModel.StudentGrade)">
<Parameter Name="StudentID" Mode="In" Type="Int32" />
</FunctionImport>
Function-Element-Anwendung
Ein Parameter-Element (als untergeordnetes Element des Function-Elements) definiert Parameter für Funktionen, die definiert oder in einem konzeptionellen Modell deklariert sind.
Das Parameter-Element kann die folgenden untergeordneten Elemente aufweisen (der vorliegenden Reihenfolge entsprechend):
Documentation (kein (null) oder ein Element)
CollectionType (kein (null) oder ein Element)
ReferenceType (kein (null) oder ein Element)
RowType (kein (null) oder ein Element)
Hinweis
Nur eines der CollectionType-, ReferenceType- oder RowType-Elemente kann ein untergeordnetes Element eines Property-Elements sein.
- Anmerkungselemente (kein (null) Element oder mehrere Elemente zugelassen)
Hinweis
Anmerkungselemente müssen an alle anderen untergeordneten Elemente angereiht werden.Anmerkungselemente sind nur in konzeptionellen Modellen für Anwendungen zulässig, die auf .NET Framework, Version 4 oder später, abzielen.Der XML-Namespace für diese Modelle ist https://schemas.microsoft.com/ado/2008/09/edm.
Anwendbare Attribute
In der folgenden Tabelle werden die Attribute beschrieben, die für das Parameter-Element übernommen werden können.
Attributname |
Ist erforderlich |
Value |
|---|---|---|
Name |
Ja |
Der Name des Parameters. |
Type |
Nein |
Der Typ des Parameters.Ein Parameter kann einer der folgenden Typen (oder Auflistungen dieser Typen) sein:
Weitere Informationen zu diesen Typen finden Sie unter Konzeptionelle Modelltypen (CSDL). |
Nullable |
Nein |
True (Standardwert) oder False, je nach dem, ob die Eigenschaft über einen null-Wert verfügen kann. |
DefaultValue |
Nein |
Der Standardwert der Eigenschaft. |
MaxLength |
Nein |
Die maximale Länge des Eigenschaftswerts. |
FixedLength |
Nein |
True oder False, abhängig davon, ob der Eigenschaftswert als Zeichenfolge mit fester Länge gespeichert wird. |
Precision |
Nein |
Die Genauigkeit des Eigenschaftswerts. |
Scale |
Nein |
Die Skalierung des Eigenschaftswerts. |
Unicode |
Nein |
True oder False, abhängig davon, ob der Eigenschaftswert als Unicode-Zeichenfolge gespeichert wird. |
Collation |
Nein |
Eine Zeichenfolge, die die Sortierreihenfolge angibt, die in der Datenquelle verwendet werden soll. |
Hinweis
Eine beliebige Anzahl von Anmerkungsattributen (benutzerdefinierte XML-Attribute) kann für das Parameter-Element übernommen werden.Benutzerdefinierte Attribute dürfen jedoch zu keinem XML-Namespace gehören, der für CSDL reserviert ist.Die vollqualifizierten Namen für zwei benutzerdefinierte Attribute dürfen nicht übereinstimmen.
Beispiel
Das folgende Beispiel zeigt ein Function-Element, das ein untergeordnetes Parameter-Element verwendet, um einen Funktionsparameter zu definieren.
<Function Name="GetYearsEmployed" ReturnType="Edm.Int32">
<Parameter Name="Instructor" Type="SchoolModel.Person" />
<DefiningExpression>
Year(CurrentDateTime()) - Year(cast(Instructor.HireDate as DateTime))
</DefiningExpression>
</Function>
Siehe auch
Aufgaben
How to: Import a Stored Procedure
How to: Define Custom Functions in the Conceptual Model
Konzepte
Übersicht über das Entity Framework
EntityContainer-Element (CSDL)