Beispiel: Ausführen mehrerer Anforderungen

Dieses Beispiel zeigt, wie Sie mehrere Organisationsnachrichtenanforderungen mithilfe eines einzelnen Webdienst-Methodenaufrufs ausführen und als ExecuteMultipleRequest als Parameter übergeben. Das Reduzieren der Anzahl der Nachrichtenanforderungen, die über das Netzwerk gesendet werden müssen, führt zu einer höheren Nachrichtenverarbeitungsleistung.

SDK für .NET: Mehrere Anforderungen ausführen – Beispielcode

Wie man dieses Beispiel ausführt

1. Um eine lokale Kopie zu erhalten, laden Sie den Beispielbericht herunter, oder klonen Sie ihn.
2. (Optional) Bearbeiten Sie die dataverse/App.config-Datei so, dass sie eine Verbindungszeichenfolge festlegt, aus der die Microsoft Dataverse-Instanz hervorgeht, zu der Sie eine Verbindung herstellen möchten.
3. Um das Beispiel auszuführen, öffnen Sie die Beispiellösung in Visual Studio, und drücken Sie F5. Nachdem Sie in der dataverse/App.config-Datei eine Verbindungszeichenfolge angegeben haben, nutzen alle Beispiele, die Sie ausführen, diese Verbindungsdaten.

Wenn Sie in der dataverse/App.config-Datei keine Verbindungszeichenfolge angeben, wird bei jeder Ausführung eines Beispiels ein Dialogfeld geöffnet, in dem Sie eingeben müssen, zu welcher Dataverse-Instanz Sie eine Verbindung herstellen und welche Anmeldeinformationen Sie verwenden möchten. Vorherige Verbindungen werden im Dialogfeld zwischengespeichert, sodass Sie aus zuvor verwendeten Verbindungen auswählen können.

Diejenigen Beispiele aus dem Bericht, die zu ihrer Ausführung eine Verbindung zu einer Instanz von Dataverse benötigen, enthalten eine verknüpfte Referenz zur dataverse/App.config-Datei.

Funktionsweise

Die ExecuteMultipleRequest Message wird in einem Szenario verwendet werden, in der sie Daten enthält, die erforderlich ist, um mindestens eine Nachrichtenanforderungen als einem Batchbetrieb auszuführen und optional einer Sammlung Ergebnisse zurückgegeben werden.

Wie dieses Beispiel funktioniert

Um das unter Was macht dieses Beispiel, beschriebene Szenario zu simulieren, geht das Beispiel wie folgt vor:

Einrichten

Prüft auf aktuelle Version der Organisation.

Demonstrieren

1. Die ExecuteMultipleRequest Methode erstellt das ExecuteMultipleRequest-Objekt.
2. Die ExecutingMultipleSettings Methode weist Einstellungen zu, die Ausführungsverhalten definiert: auf Fehler fortfahren, Rückantworten.
3. Die OrganizationRequestCollection Methode erstellt eine leere Organisationsanforderungssammlung.
4. Die Methode CreateRequest wird für jede Tabelle zur Anforderungssammlung hinzugefügt.
5. Die Klasse GetCollectionOdEntitiesToUpdate aktualisiert die zuvor erstellten Tabellen.

Bereinigung

Zeigt eine Option an, um die Datensätze zu löschen, die in der Einrichtungerstellt wurden. Das Löschen ist optional, falls Sie die vom Beispiel erstellten Tabellen und Daten untersuchen möchten. Sie können die Datensätze manuell löschen, um das gleiche Ergebnis zu erzielen.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).