Implementieren eines IdEnumerators
Letzte Änderung: Dienstag, 20. April 2010
Gilt für: SharePoint Server 2010
Inhalt dieses Artikels
Beschreibung
Syntax
Hinweise
Beispiele
Beschreibung
Mit einer IdEnumerator-Methodeninstanz im externen System können Sie die Feldwerte zurückgeben, die die Identität von Entity-Instanzen einer bestimmten Entity darstellen. Die IdEnumerator-Eingabe wird durch Filterdeskriptoren definiert, die sich in der Methode befinden, in der der IdEnumerator zum Abrufen der Liste der IDs enthalten ist, das heißt der Liste der eindeutigen Schlüssel für jede Entität, die durchsuchbar sein soll. Mit dieser Methodeninstanz wird die externe Datensuche in Microsoft SharePoint Server 2010 aktiviert.
Syntax
Im Folgenden ist eine typische Methodensignatur für eine IdEnumerator-Methode angegeben:
EntityDataTypeSimple[] EnumerateEntity ()
Hinweise
Wenn eine inkrementelle Durchforstung erforderlich ist, müssen Sie außerdem sicherstellen, dass eines der Rückgabefelder im IdEnumerator für die Entität den Zeitpunkt der letzten Aktualisierung der Entitätsinstanz (oder in Datenbankterminologie "Zeile") im externen System darstellt. Dann sollten Sie die __BdcLastModifiedTimestamp-Eigenschaft des externen Inhaltstyps auf den Namen des TypeDescriptors im Rückgabewert des IdEnumerators festlegen, der das Datum der letzten Änderung darstellt.
Entitäten haben keine oder eine IdEnumerator-Methode. IdEnumerator-Methoden sind nicht auf das Zurückgeben einer Liste von IDs beschränkt. Wenn im Rückgabeparameter weitere Felder zurückgegeben werden, werden diese bei der Durchforstung ignoriert.
Mit dem LastIdSeen-Filter wird die Batchverarbeitung für IdEnumerator-Methoden aktiviert. Verwenden Sie für Webdienste und andere Back-End-Anwendungen ohne Streaming wie im folgenden Beispiel gezeigt den LastIdSeen-Filter in der IdEnumerator-Methode, um die Leistung zu verbessern:
SELECT TOP 100 Id FROM Customers WHERE Id>=@LastIdSeen
ORDER BY Id
Beispiele
Codeausschnitt: Implementieren eines "IdEnumerator"
Siehe auch
Konzepte
XML-Codeausschnitt: Modellieren einer IdEnumerator-Methode
Codeausschnitt: Ausführen der IdEnumerator-Methodeninstanz eines externen Inhaltstyps