Send アクティビティ デザイナー
Send アクティビティ デザイナーは、Send アクティビティを作成および構成するために使用します。
Send アクティビティ
メッセージをサービスに送信するには、Send アクティビティを使用します。 ReceiveReply アクティビティは、クライアントでの要求/応答メッセージ交換パターンの一部としてメッセージを受信する Send アクティビティにバインドできます。
Send アクティビティ デザイナーの使用
[ツールボックス] の [メッセージング] カテゴリで、Send アクティビティ デザイナーにアクセスします。 Send アクティビティ デザイナーは、[ツールボックス] からドラッグして、アクティビティが通常配置される任意のワークフロー デザイナー画面にドロップできます。 この操作により、Send という既定の Send を持つ DisplayName アクティビティが作成されます。 DisplayName は、Send アクティビティ デザイナーのヘッダー、またはプロパティ グリッドの [DisplayName] ボックスで編集できます。
ReceiveReply アクティビティを作成し、選択した Send アクティビティにバインドするには、Send アクティビティ デザイナーを右クリックし、コンテキスト メニューの [ReceiveReply の作成] をクリックします。これで、Send デザイナーの下に ReceiveReplyForSend デザイナーが表示されます。 ReceiveReply アクティビティは、クライアントでの要求/応答メッセージ交換パターンの一部としてメッセージを受信するアクティビティであり、 ReceiveReplyForSend デザイナーで構成できます。
また、[ツールボックス] の [メッセージング] カテゴリの SendAndReceiveReply テンプレート デザイナーを使用して、定義済みの Send アクティビティと ReceiveReply アクティビティのペアを作成できます。 SendAndReceiveReply と ReceiveReplyForSend テンプレートの使用の詳細については、SendAndReceiveReply に関するトピックを参照してください。
Send アクティビティのプロパティ
次の表に、Send のプロパティと、デザイナーでのその使用方法を示します。 これらのプロパティは、プロパティ グリッドまたはワークフロー デザイナー画面で編集できます。
プロパティ名 | 必須 | 使用 |
---|---|---|
DisplayName | False | Send アクティビティの表示名。 既定値は Send です。 DisplayName は必須ではありませんが、使用することをお勧めします。 |
OperationName | True | この Send アクティビティによって呼び出されるサービス操作の名前。 このプロパティは、Action プロパティが明示的に設定されていない場合に、Action プロパティの既定値を構成するために使用します。 |
ServiceContractName | True | 呼び出されるサービスが実装するサービス コントラクトの名前。 |
Content | False | 受信するメッセージまたはパラメーターの内容を指定します。 ReceiveMessageContent アクティビティまたは ReceiveParametersContent アクティビティを指定できます。 このプロパティを編集するには、プロパティ グリッドで [Content] フィールドの横にある省略記号ボタンを選択するか、Receive アクティビティ デザイナー画面で [コンテンツ] というラベルの横にある [定義] ボタンをクリックします。 どちらの場合も、[コンテンツ定義] ダイアログ ボックスが表示されます。 このボックスの使用方法の詳細については、「[コンテンツ定義] ダイアログ ボックス」トピックを参照してください。 |
CorrelatesWith | False | 適切なワークフロー インスタンスにメッセージをルーティングするために使用される CorrelationHandle を指定します。 プロパティ グリッドで CorrelatesWith プロパティの横にある省略記号ボタンをクリックすると、[式エディター] ダイアログ ボックスが開きます。 このダイアログ ボックスの使用方法の詳細については、「方法: 式エディターを使用する」を参照してください。 |
CorrelationInitializers | False | ワークフロー内のこの CorrelationInitializer アクティビティを構成する複数の CorrelationHandle オブジェクトを初期化する Send オブジェクトのコレクションを指定します。 プロパティ グリッドで CorrelationInitializers プロパティの横にある省略記号ボタンをクリックすると、[関連付け初期化子の追加] ダイアログ ボックスが開きます。 このボックスの使用方法の詳細については、「[関連付け初期化子の追加] ダイアログ ボックス」トピックを参照してください。 |
KnownTypes | False | この Send アクティビティによって呼び出されるサービス操作の既知の型のコレクション。 このプロパティは、SerializerOption に設定された DataContractSerializer プロパティと共に使用する必要があります。 XmlSerializer が使用されている場合は無視されます。 プロパティ グリッドで [KnownTypes] フィールドの横にある省略記号ボタンを選択して、[型コレクション エディター] ダイアログを開きます。このダイアログで、該当する型を追加できます。 プロパティ グリッドで [KnownTypes] フィールドの横にある省略記号ボタンを選択して、[型コレクション エディター] ダイアログ ボックスを開きます。このダイアログで、該当する型を追加できます。 このボックスの使用方法の詳細については、「[型コレクション エディター] ダイアログ ボックス」を参照してください。 |
ProtectionLevel | True | メッセージの ProtectionLevel を指定します。 1. ProtectionLevel は、認証のみを意味します。 2. ProtectionLevel は、送信されるデータの整合性の確保に役立つ署名データを意味します。 3. ProtectionLevel は、送信されるデータの機密性と整合性の確保に役立つ暗号化と署名データを意味します。 |
SerializerOption | True | Send アクティビティによって呼び出されるサービス操作に使用するシリアライザー。 既定値は DataContractSerializer です。このシリアライザーは、ある型のインスタンスを、提供されたデータ コントラクトを使用する XML ストリームまたはドキュメントへとシリアル化または逆シリアル化します。 |
Action | False | メッセージのアクション ヘッダーを指定します。 これを明示的に設定しない場合は、次の既定値が設定されます: https://tempuri.org/{service contract namespace}/{service contract name}/{operation name} 。 Send アクティビティで指定した場合は、メッセージを正しく配信するために、メッセージを受信する Receive アクティビティに同じ値を設定する必要があります。 |
TokenImpersonationLevel | メッセージの受信側に許可される TokenImpersonationLevel。 サーバー プロセスがクライアント プロセスの代わりに機能できる程度を制御するセキュリティ偽装レベルを定義します。TokenImpersonationLevel は、偽装レベルが割り当てられていないことを示します。 TokenImpersonationLevel は、サーバー プロセスがクライアントの識別情報を取得することも、クライアントを偽装することもできないことを示します。 TokenImpersonationLevel は、サーバー プロセスがセキュリティ ID や特権などのクライアント情報を取得できるが、クライアントを偽装できないことを示します。 これは、テーブルとビューをエクスポートするデータベース製品など、独自のオブジェクトをエクスポートするサーバーで役立ちます。 サーバーは、このクライアントのセキュリティ コンテキストを使用する他のサービスを使用できなくても、取得したクライアントのセキュリティ情報を使用してアクセス検証に関する決定を行うことができます。 TokenImpersonationLevel は、サーバー プロセスがローカル システム上にあるクライアントのセキュリティ コンテキストを偽装できることを示します。 サーバーは、リモート システムにあるクライアントを偽装できません。 TokenImpersonationLevel は、サーバー プロセスがリモート システム上にあるクライアントのセキュリティ コンテキストを偽装できることを示します。 | |
Endpoint | Endpoint アクティビティによるメッセージの送信先の Send。 このプロパティを設定した場合は、EndpointConfigurationName プロパティを null にする必要があります。 | |
EndpointAddress | メッセージの送信先となる EndpointAddress。 | |
EndpointConfigurationName | エンドポイント構成の名前。 このプロパティは、エンドポイントを構成ファイルで構成している場合に設定します。 このプロパティは、構成ファイルの <endpoint> 要素で指定されている名前に設定する必要があります。 このプロパティを設定した場合は、Endpoint プロパティを null にする必要があります。 |