Receive-Aktivitätsdesigner

Der Receive-Aktivitätsdesigner wird verwendet, um eine Receive-Aktivität zu erstellen und zu konfigurieren. Eine Receive-Aktivität ist eine Aktivität, die eine Nachricht empfängt, die entweder ein integrierter Datentyp, etwa ein Message-, Stream- oder ein XElement-Typ sein kann oder ein anwendungsdefinierter Datenvertrag, ein Nachrichtenvertrag oder eine XML-Klasse, die serialisiert werden kann.

Die Receive-Aktivität

Die Receive-Aktivität kann abhängig vom Typ des verwendeten Empfangsinhalts ein einzelnes Element oder mehrere Elemente empfangen. Eine SendReply-Aktivität kann an eine Receive-Aktivität gebunden werden, die eine Nachricht als Teil eines Anforderungs-/Antwort-Nachrichtenaustauschmusters des Dienstes empfängt.

Verwenden des Receive-Aktivitätsdesigners

Der Receive-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 Symbolleiste auswählen oder STRG+ALT+X drücken).

Der Receive-Aktivitätsdesigner kann aus der Toolbox gezogen und auf der Workflow-Designer-Oberfläche dort abgelegt werden, wo Aktivitäten normalerweise platziert werden. Dadurch wird eine Receive-Aktivität mit dem standardmäßigen DisplayName Receive erstellt. Der DisplayName-Wert kann im Header des Receive-Aktivitätsdesigners oder im Feld DisplayName des Eigenschaftenrasters bearbeitet werden.

Um eine SendReply-Aktivität zu erstellen und an die ausgewählte Receive-Aktivität zu binden, klicken Sie mit der rechten Maustaste auf den Receive-Aktivitätsdesigner, und klicken Sie im Kontextmenü auf den Befehl SendReply erstellen. Daraufhin wird unterhalb des Receive-Designers der SendReplyToReceive-Designer angezeigt. Die SendReply-Aktivität ist eine Aktivität, die die Antwortnachricht als Teil eines Anforderungs-/Antwort-Nachrichtenaustauschmusters des Dienstes sendet. Sie kann mit dem SendReplyToReceive-Designer konfiguriert werden.

Alternativ kann der ReceiveAndSendReply-Vorlagendesigner in der Kategorie Messaging der Toolbox verwendet werden, um ein Paar vorkonfigurierter Receive- und SendReply-Aktivitäten zu erstellen. Weitere Informationen über zur Verwendung der ReceiveAndSendReply- und SendReplyToReceive-Vorlagen finden Sie im Thema ReceiveAndSendReply-Vorlagendesigner.

Die Receive-Aktivitätseigenschaften

In der folgenden Tabelle werden die Eigenschaften von Receive gezeigt, und es wird beschrieben, wie sie im Designer verwendet werden. Diese Eigenschaften können im Eigenschaftenraster oder auf der Workflow-Designer-Oberfläche bearbeitet werden. Die einzige erforderliche Eigenschaft ist die OperationName-Eigenschaft.

Eigenschaftenname	Erforderlich	Verwendung
DisplayName	False	Gibt den benutzerfreundlichen Namen der Receive-Aktivität an. Der Standardwert lautet Receive. Obwohl die Verwendung eines nicht standardmäßigen Werts für den benutzerfreundlichen DisplayName nicht zwingend erforderlich ist, wird empfohlen, einen solchen Wert zu verwenden.
OperationName	True	Gibt den Namen des von dieser Receive-Aktivität implementierten Dienstvorgangs an. Diese Eigenschaft wird verwendet, um den Standardwert für die Action-Eigenschaft festzulegen, wenn die Action-Eigenschaft nicht explizit festgelegt wurde.
ServiceContractName	False	Gibt den Namen des Dienstvertrags an. Diese Eigenschaft wird verwendet, um Dienstvorgänge in einzelne Dienstverträge zu gruppieren. Alle Receive-Aktivitäten, die über den gleichen ServiceContractName verfügen, werden in den gleichen Dienstvertrag (WSDL-Anschlusstyp) gruppiert. Der Standardwert ist der vollqualifizierte CLR-Name der Aktivität der obersten Ebene (der Stammaktivität).
Content	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).
CorrelatesOn	False	Gibt die Korrelationen zwischen Receive-Aktivitäten in Dienstvorgängen eines Workflows mit einem MessageQuerySet-Objekt an. Klicken Sie im Eigenschaftenraster auf die Schaltfläche mit den Auslassungspunkten neben der CorrelatesOn-Eigenschaft, um das Dialogfeld CorrelatesOn-Definition zu öffnen. Weitere Informationen über zur Verwendung dieses Dialogfelds finden Sie im Thema Inhaltsdefinition (Dialogfeld).
CorrelatesWith	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.
CorrelationInitializers	False	Gibt die Auflistung von CorrelationInitializer-Objekten an, die mehrere CorrelationHandle-Objekte initialisiert, die diese Receive-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).
CanCreateInstance	False	Gibt einen Wert an, der bestimmt, ob eine neue Workflowinstanz zur Verarbeitung der Nachricht erstellt wird, wenn die Nachricht keiner vorhandenen Workflowinstanz entspricht. Ist der Wert auf true festgelegt, wird eine neue Workflowinstanz erstellt, um eine Nachricht zu verarbeiten, die keiner vorhandenen Workflowinstanz entspricht.
KnownTypes	False	Gibt eine Auflistung bekannter Typen für den von dieser Receive-Aktivität implementierten Dienstvorgang an. 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 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).
ProtectionLevel	False	Gibt die ProtectionLevel-Einstellung für die Nachricht an. None bedeutet: nur Authentifizierung. Sign bedeutet, dass Daten signiert werden, um die Integrität übertragener Daten sicherzustellen. EncryptAndSign bedeutet, dass Daten verschlüsselt und signiert werden, um die Vertraulichkeit und Integrität übertragener Daten sicherzustellen.
SerializerOption	False	Gibt den Typ des Serialisierungsprogramms an, das für den von der Receive-Aktivität implementierten Dienstvorgang verwendet werden soll. Der Standardwert ist DataContractSerializer, der eine Instanz eines Typs, der einen angegebenen Datenvertrag verwendet, in einen XML-Datenstrom oder ein Dokument serialisiert und deserialisiert. Der XmlSerializer kann auch verwendet werden, wenn eine genauere Kontrolle des XML-Codes erforderlich ist.
Action	False	Gibt den Aktionsheader der Nachricht an. Wenn nicht explizit festgelegt, lautet sein Standardwert: https://tempuri.org/{Dienstvertragsnamespace}/{Dienstvertragsname}/{Vorgangsname}.

Siehe auch

Konzepte

InitializeCorrelation-Aktivitätsdesigner
CorrelationScope-Aktivitätsdesigner
ReceiveAndSendReply-Vorlagendesigner
Send-Aktivitätsdesigner
SendAndReceiveReply-Vorlagendesigner
TransactedReceiveScope-Aktivitätsdesigner