Send-Aktivitätsdesigner
Der Send-Aktivitätsdesigner wird verwendet, um eine Send-Aktivität zu erstellen und zu konfigurieren.
Die Send-Aktivität
Eine Send-Aktivität wird verwendet, um eine Nachricht an einen Dienst zu senden. Eine ReceiveReply-Aktivität kann an eine Send-Aktivität gebunden werden, die eine Nachricht als Teil eines Anforderungs-/Antwort-Nachrichtenaustauschmusters auf dem Client empfängt.
Verwenden des Send-Aktivitätsdesigners
Der Send-Aktivitätsdesigner befindet sich in der 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 Send-Aktivitätsdesigner kann aus der Toolbox gezogen und auf der Workflow-Designer-Oberfläche dort abgelegt werden, wo Aktivitäten normalerweise platziert werden. Daraufhin wird eine Send-Aktivität mit dem DisplayName-Standardwert Sent erstellt. Der DisplayName-Wert kann im Header des Send-Aktivitätsdesigners oder im Feld DisplayName des Eigenschaftenrasters bearbeitet werden.
Um eine ReceiveReply-Aktivität zu erstellen und an die ausgewählte Send-Aktivität zu binden, klicken Sie mit der rechten Maustaste auf den Send-Aktivitätsdesigner, und klicken Sie im Kontextmenü auf den Befehl ReceiveReply erstellen. Daraufhin wird unterhalb des Send-Designers der ReceiveReplyForSend-Designer angezeigt. Die ReceiveReply-Aktivität ist eine Aktivität, die eine Nachricht als Teil eines Anforderungs-/Antwort-Nachrichtenaustauschmusters auf dem Client empfängt. Sie kann mit dem ReceiveReplyForSend-Designer konfiguriert werden.
Alternativ kann der SendAndReceiveReply-Vorlagendesigner in der Kategorie Messaging der Toolbox verwendet werden, um ein Paar vorkonfigurierter Send- und ReceiveReply-Aktivitäten zu erstellen. Weitere Informationen über zur Verwendung der SendAndReceiveReply-Vorlage und der ReceiveReplyForSend-Vorlage finden Sie im Thema SendAndReceiveReply-Vorlagendesigner.
Die Eigenschaften der Sent-Aktivität
In der folgenden Tabelle werden die Send-Eigenschaften aufgeführt, und es wird beschrieben, wie sie im Designer verwendet werden. Diese Eigenschaften können im Eigenschaftenraster oder in der Workflow-Designer-Oberfläche bearbeitet werden.
| Eigenschaftenname | Erforderlich | Verwendung |
|---|---|---|
DisplayName |
False |
Gibt den Anzeigenamen der Send-Aktivität an. Der Standardwert lautet Sent. Obwohl der DisplayName nicht zwingend erforderlich ist, wird empfohlen, einen Anzeigenamen zu verwenden. |
True |
Der Name des Dienstvorgangs, der von dieser Send-Aktivität aufgerufen wurde. Diese Eigenschaft wird verwendet, um den Standardwert für die Action-Eigenschaft festzulegen, wenn die Action-Eigenschaft nicht explizit festgelegt wurde. |
|
True |
Der Name des Dienstvertrags, der von dem aufzurufenden Dienst implementiert wird. |
|
False |
Gibt die zu empfangende Nachricht oder den zu empfangenden Parameterinhalt an. Dies kann entweder eine ReceiveMessageContent-Aktivität oder eine ReceiveParametersContent-Aktivität sein. Bearbeiten Sie diese Eigenschaft, indem Sie im Eigenschaftenraster neben dem Content-Feld auf die Schaltfläche mit den Auslassungspunkten klicken. Oder klicken Sie neben der Bezeichnung Inhalt auf der Designer-Oberfläche der Receive-Aktivität auf die Schaltfläche Definieren…. Daraufhin wird das Dialogfeld Inhaltsdefinition angezeigt. Weitere Informationen über zur Verwendung dieses Dialogfelds finden Sie im Thema Inhaltsdefinition (Dialogfeld). |
|
False |
Gibt den CorrelationHandle an, der verwendet wurde, um die Nachricht an die entsprechende Workflowinstanz weiterzuleiten. Klicken Sie im Eigenschaftenraster auf die Schaltfläche mit den Auslassungspunkten neben der CorrelatesWith-Eigenschaft, um das Dialogfeld Ausdrucks-Editor zu öffnen. Weitere Informationen über zur Verwendung dieses Dialogfelds finden Sie im Thema Vorgehensweise: Verwenden des Ausdrucks-Editors. |
|
False |
Gibt die Auflistung von CorrelationInitializer-Objekten an, die mehrere CorrelationHandle-Objekte initialisiert, die diese Send-Aktivität im Workflow konfigurieren. Klicken Sie im Eigenschaftenraster auf die Schaltfläche mit den Auslassungspunkten neben der CorrelationInitializers-Eigenschaft, um das Dialogfeld Korrelationsinitialisierer hinzufügen zu öffnen. Weitere Informationen über zur Verwendung dieses Dialogfelds finden Sie im Thema CorrelationInitializers hinzufügen (Dialogfeld). |
|
False |
Eine Auflistung bekannter Typen für den von dieser Send-Aktivität aufzurufenden Dienstvorgang. Diese Eigenschaft muss in Verbindung mit der SerializerOption-Eigenschaft verwendet werden, die auf DataContractSerializer festgelegt wurde. Sie wird ignoriert, wenn der XmlSerializer verwendet wird. Klicken Sie im Eigenschaftenraster neben dem Feld KnownTypes auf die Schaltfläche mit den Auslassungspunkten, um das Dialogfeld Typauflistungs-Editor zu öffnen, in dem Sie relevante Typen hinzufügen können. Klicken Sie im Eigenschaftenraster auf die Schaltfläche mit den Auslassungspunkten neben dem Feld KnownTypes, um das Dialogfeld Typauflistungs-Editor zu öffnen, in dem Sie relevante Typen hinzufügen können. Weitere Informationen über zur Verwendung dieses Dialogfelds finden Sie im Thema Typauflistungs-Editor (Dialogfeld). |
|
True |
Gibt die ProtectionLevel-Einstellung für die Nachricht an.
|
|
True |
Das Serialisierungsprogramm, das für den Dienstvorgang verwendet werden soll, der von der Send-Aktivität aufgerufen werden soll. Der Standardwert lautet DataContractSerializer, der unter Verwendung eines angegebenen Datenvertrags eine Instanz eines Typs in einen XML-Datenstrom oder ein Dokument serialisiert und daraus deserialisiert. |
|
False |
Gibt den Aktionsheader der Nachricht an. Wenn er nicht explizit festgelegt wird, lautet sein Standardwert: |
|
Die für den Empfänger der Nachricht zulässige TokenImpersonationLevel-Instanz. Sie definiert die Sicherheitsidentitätswechselebenen, die den Grad regeln, zu dem ein Serverprozess im Namen eines Clientprozesses agieren kann. None gibt an, dass keine Identitätswechselebene zugewiesen wurde. Anonymous gibt an, dass der Serverprozess keine Identifikationsinformationen zum Client abrufen und die Identität des Clients nicht annehmen kann. Identification gibt an, dass der Serverprozess zwar Informationen zum Client abrufen, z. B. Sicherheits-IDs und Berechtigungen, aber nicht die Identität des Clients annehmen kann. Dies ist nützlich für Server, die eigene Objekte exportieren (z. B. Datenbankprodukte, von denen Tabellen und Ansichten exportiert werden). Mithilfe der abgerufenen Clientsicherheitsinformationen kann der Server Entscheidungen über die Validierung des Zugriffs treffen, ohne in der Lage zu sein, andere Dienste zu nutzen, die den Sicherheitskontext des Clients verwenden. Impersonation gibt an, dass der Serverprozess auf seinem lokalen System einen Identitätswechsel für den Sicherheitskontext des Clients durchführen kann. Der Server kann keinen Identitätswechsel für den Client auf Remotesystemen durchführen. Delegation gibt an, dass der Serverprozess auf Remotesystemen einen Identitätswechsel für den Sicherheitskontext des Clients durchführen kann. |
||
Das Endpoint-Objekt, an das die Send-Aktivität eine Nachricht sendet. Wenn diese Eigenschaft festgelegt wird, sollte die EndpointConfigurationName-Eigenschaft den Wert NULL haben. |
||
Das EndpointAddress-Objekt, an das die Meldung gesendet wird. |
||
EndpointConfigurationName |
Der Name der Endpunktkonfiguration. Diese Eigenschaft wird beim Konfigurieren eines Endpunkts in einer Konfigurationsdatei festgelegt. Diese Eigenschaft sollte auf den im <endpoint>-Element in der Konfigurationsdatei angegebenen Namen festgelegt werden. Wenn diese Eigenschaft festgelegt wird, sollte die Endpoint-Eigenschaft den Wert NULL haben. |
Siehe auch
Konzepte
InitializeCorrelation-Aktivitätsdesigner
CorrelationScope-Aktivitätsdesigner
ReceiveAndSendReply-Vorlagendesigner
Receive-Aktivitätsdesigner
SendAndReceiveReply-Vorlagendesigner
TransactedReceiveScope-Aktivitätsdesigner