MethodInstance-Element in "MethodInstances" (BDCMetadata-Schema)

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

Gibt ein MethodInstance-Element an.

Namespace: http://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Schema: BDCMetadata

Hinweis

Die folgenden beiden Fälle in einem BDC-Modell führen zur Laufzeit zu einer InvalidOperationException :

• Zwei SpecificFinder-Methodeninstanzen, von denen dieselben Felder zurückgegeben werden.
• Zwei SpecificFinder-Methodeninstanzen, die die gleiche Anzahl von Feldern aufweisen und die gleiche Anzahl von Feldern mit einer anderen Methodeninstanz gemeinsam verwenden, wie z. B. die Finder-Methode.

<MethodInstance Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </MethodInstance>

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
**Typ**	Erforderlich. Gibt den Typ der **MethodInstance** an. Die folgende Tabelle listet die möglichen Werte für dieses Attribut auf. Wert Beschreibung Finder Ein **MethodInstance**-Typ, der aufgerufen werden kann, um eine Auflistung von null oder mehr **EntityInstances** einer bestimmten **Entität** zurückzugeben. Die **Finder**-Eingabe wird durch die **FilterDescriptors** definiert, die in der **Methode** enthalten sind, die den **Finder** enthält. SpecificFinder Ein **MethodInstance**-Typ, der aufgerufen werden kann, um eine bestimmte **EntityInstance** einer bestimmten **Entität** unter Berücksichtigung ihrer **EntityInstanceId** zurückzugeben. **SpecificFinder**-Eingaben werden durch die **Bezeichner** definiert und sortiert, die der **Entität** zugeordnet sind. GenericInvoker Ein **MethodInstance**-Typ, der aufgerufen werden kann, um eine bestimmte Aufgabe in einem externen System auszuführen. Die Eingabe und Ausgabe von **GenericInvoker** ist spezifisch für die **Methode**. IdEnumerators Ein **MethodInstance**-Typ, der aufgerufen werden kann, um die **Field**-Werte zurückzugeben, die die Identität von **EntityInstances** einer bestimmten **Entität** darstellen. Die **IdEnumerator**-Eingabe wird durch die **FilterDescriptors** definiert, die in der Methode enthalten sind, die den **IdEnumerator** enthält, um die Liste der IDs abzurufen, bei denen es sich um die eindeutigen Schlüssel für jede Entität handelt, die durchsuchbar sein sollten. Diese Methodeninstanz ermöglicht die Suche nach externen Daten in Microsoft SharePoint Server 2010. ChangedIdEnumerator Ein **MethodInstance-Typ**, der aufgerufen werden kann, um **EntityInstanceIds** von **EntityInstances** abzurufen, die nach einer bestimmten Zeit in einem externen System geändert wurden. DeletedIdEnumerator Ein **MethodInstance**-Typ, der aufgerufen werden kann, um **EntityInstanceIds** von **EntityInstances** abzurufen, die nach der angegebenen Zeit aus einem externen System gelöscht wurden. Scalar Eine **MethodInstance**, die einen einzelnen Wert zurückgibt, den Sie im externen System aufrufen können. Beispielsweise können Sie mithilfe einer skalaren Methodeninstanz den Gesamtumsatz bis dato aus dem externen System abrufen. **Entitäten** verfügen über null oder mehr Skalarmethodeninstanzen. AccessChecker Ein **MethodInstance-Typ**, der aufgerufen werden kann, um die Berechtigungen abzurufen, die der aufrufende Sicherheitsprinzipal für jede auflistung von **EntityInstances** besitzt, die durch die angegebenen **EntityInstanceIds** identifiziert werden. Creator Ein **MethodInstance**-Typ, der aufgerufen werden kann, um eine **EntityInstance** zu erstellen. Der Satz von Feldern, die zum Erstellen der **EntityInstance** erforderlich sind, wird als Erstelleransicht bezeichnet. Deleter Ein **MethodInstance**-Typ, der aufgerufen werden kann, um **EntityInstance** mit einer angegebenen **EntityInstanceId** zu löschen. Updater Ein **MethodInstance**-Typ, der aufgerufen werden kann, um eine **EntityInstance** zu aktualisieren, die durch eine angegebene **EntityInstanceId** identifiziert wird. Der Satz von Feldern, die zum Aktualisieren von **EntityInstance** erforderlich sind, wird als Updateransicht bezeichnet. The set of fields whose values should be passed before they are changed is known as the PreUpdater View. StreamAccessor Ein **MethodInstance**-Typ, der aufgerufen werden kann, um ein Feld einer **EntityInstance** in Form eines Bytedatenstroms abzurufen. BinarySecurityDescriptorAccessor Ein **MethodInstance-Typ**, der aufgerufen werden kann, um eine Bytesequenz aus einem externen System abzurufen. Die systemspezifische Bytesequenz beschreibt einen Satz von Sicherheitsprinzipalen und die zugehörigen Berechtigungen, die jeder Sicherheitsprinzipal für die **EntityInstance** hat, die durch eine angegebene **EntityInstanceId** identifiziert wird. Des BulkSpecificFinder Ein **MethodInstance**-Typ, der aufgerufen werden kann, um einen Satz von bestimmten **EntityInstances** einer **Entität** zurückzugeben, wenn ein Satz entsprechender **EntityInstanceIds** vorhanden ist. BulkIdEnumerator Ein **MethodInstance**-Typ, der aufgerufen werden kann, um minimale Informationen zu den externen Elementen abzurufen, die den angegebenen Identitäten entsprechen. Diese Methodeninstanz kann verwendet werden, um die Synchronisierung zwischengespeicherter Daten zu optimieren. Diese Methode sollte nur die Identitäten und Versionsinformationen der externen Elemente zurückgeben, die den angegebenen **Identitäten** entsprechen, die die aufrufende Anwendung mit der lokalen Version vergleichen kann, um festzustellen, ob sich etwas geändert hat, und wenn ja, fordern Sie die geänderten externen Elemente auf, die zwischengespeicherten Daten zu aktualisieren.
**Standard**	Optional. Gibt an, ob **MethodInstance** die Standardeinstellung aller **MethodInstances** ist, die ihren Typ innerhalb des enthaltenden externen Inhaltstyps (**Entity**) gemeinsam nutzen. Standardwert: **false** Attributtyp: **Boolean**
**ReturnParameterName**	Optional. Der Name des **Parameters**, der den **ReturnTypeDescriptor** der **MethodInstance** enthält. Das **Direction**-Attribut des **Parameters** muss ein **ParameterDirection**-Attribut mit dem Wert **Out**, **InOut** oder **Return** sein. Dieses Attribut muss für alle Typen von **MethodInstances** mit Ausnahme von **GenericInvoker**, **Creator**, **Deleter** und **Updater** angegeben werden. Attributtyp: **String**
**ReturnTypeDescriptorLevel**	Optional. Veraltet. Verwenden Sie stattdessen **ReturnTypeDescriptorPath**. Attributtyp: **Integer**
**ReturnTypeDescriptorPath**	Optional. Der gepunktete Pfad des **TypeDescriptor** der Zuordnung. Attributtyp: **String**
**Namen**	Erforderlich. Gibt den Namen von **MethodInstance** an. Attributtyp: **String**
**DefaultDisplayName**	Optional. Gibt den Standardanzeigenamen für **MethodInstance** an. Attributtyp: **String**
**IsCached**	Optional. Gibt an, ob **MethodInstance** häufig verwendet wird. Standardwert: **true** Attributtyp: **Boolean**

Untergeordnete Elemente

Element	Beschreibung
LocalizedDisplayNames-Element in "MetadataObject" (BDCMetadata-Schema)	Die lokalisierten Anzeigenamen von MethodInstance.
Properties-Element in MetadataObject (BDCMetadata-Schema)	Die Eigenschaften des MethodInstance-Parameters.
AccessControlList-Element (BDCMetadata-Schema)	Die Zugriffssteuerungslisten (Access Control Lists, ACLs) von MethodInstance.

Übergeordnete Elemente

Element	Beschreibung
"MethodInstances"-Element in "Method" ("BDCMetadata"-Schema)	Das MethodInstances-Element, das diesen MethodInstance-Parameter enthält.