InitializeCorrelation-Aktivitätsdesigner
Der InitializeCorrelation-Aktivitätsdesigner wird verwendet, um eine InitializeCorrelation-Aktivität zu erstellen, die verwendet wird, um eine Korrelation zwischen Nachrichten festzulegen und zu konfigurieren, bevor diese gesendet oder empfangen werden.
Die InitializeCorrelation-Aktivität
Eine InitializeCorrelation-Aktivität wird verwendet, um Korrelationen zu initialisieren, ohne eine Nachricht zu senden oder zu empfangen. In der Regel wird die Korrelation durch das Senden oder Empfangen einer Nachricht initialisiert. Wenn eine Korrelation festgelegt werden muss, bevor eine Nachricht gesendet oder empfangen wird, verwenden Sie InitializeCorrelation, um die Korrelation zu initialisieren.
Verwenden des InitializeCorrelation-Aktivitätsdesigners
Der InitializeCorrelation-Aktivitätsdesigner befindet sich in die Kategorie Messaging der Toolbox, auf die Sie zugreifen können, indem Sie in Workflow-Designer auf die Registerkarte Toolbox klicken (Sie können auch im Menü Ansicht den Befehl Toolbox auswählen oder STRG+ALT+X drücken).
Der InitializeCorrelation-Aktivitätsdesigner kann aus der Toolbox gezogen und auf der Workflow-Designer-Oberfläche abgelegt werden. Daraufhin wird eine InitializeCorrelation-Aktivität mit dem DisplayName-Standardwert InitializeCorrelation erstellt. Der DisplayName-'Wert kann im Header des InitializeCorrelation-Aktivitätsdesigners oder dem Feld DisplayName des Fensters Eigenschaften bearbeitet werden.
Das CorrelationHandle-Objekt kann im Feld Korrelation im Fenster Eigenschaften auf der InitializeCorrelation-Aktivitätsdesigneroberfläche angegeben werden.
Wenn Sie auf die Schaltfläche mit den Auslassungspunkten neben dem Feld CorrelationData im Fenster Eigenschaften oder auf den Hinweistext "View …" auf der InitializeCorrelation-Aktivitätsdesigneroberfläche klicken, wird das Dialogfeld Korrelation initialisieren angezeigt, in dem Sie das Korrelationshandle und die Schlüssel-Wert-Paare angeben können, die zum Initialisieren verwendet werden. Weitere Informationen über zur Verwendung dieses Dialogfelds finden Sie im Thema Typauflistungs-Editor (Dialogfeld).
Die InitializeCorrelation-Eigenschaften
In der folgenden Tabelle werden die InitializeCorrelation-Eigenschaften aufgeführt, und es wird beschrieben, wie sie im Designer verwendet werden. Diese Eigenschaften können im Fenster Eigenschaften oder in der Workflow-Designer-Oberfläche bearbeitet werden.
| Eigenschaftenname | Erforderlich | Verwendung |
|---|---|---|
DisplayName |
False |
Gibt den Anzeigenamen der InitializeCorrelation-Aktivität an. Der Standardwert lautet InitializeCorrelation. Obwohl die Verwendung eines nicht standardmäßigen Werts für den benutzerfreundlichen DisplayName nicht zwingend erforderlich ist, wird empfohlen, einen solchen Wert zu verwenden. |
False |
Das CorrelationHandle-Objekt, das verwendet wurde, um Workflowaktivitäten in der Korrelation zuzuordnen. |
|
False |
Ein Wörterbuch von Korrelationsdaten, die Nachrichten mit der Workflowinstanz verknüpft. Verwenden Sie das Dialogfeld Korrelation initialisieren, um die CorrelationData-Instanz zu konfigurieren. Weitere Informationen über zur Verwendung dieses Dialogfeld finden Sie im Thema Typauflistungs-Editor (Dialogfeld). |
Siehe auch
Konzepte
CorrelationScope-Aktivitätsdesigner
Receive-Aktivitätsdesigner
ReceiveAndSendReply-Vorlagendesigner
Send-Aktivitätsdesigner
SendAndReceiveReply-Vorlagendesigner
TransactedReceiveScope-Aktivitätsdesigner