次の方法で共有

マルチパート メッセージの種類を使用する方法

  • [アーティクル]

各メッセージには、マルチパート メッセージの種類、0 個以上のメッセージ部分で構成されるメッセージ構造の記述があります。 これらの部分は、XSD (XML Schema Definition) 言語スキーマまたは .NET クラスによって定義されます。 独自のマルチパート メッセージの種類を定義したり、既存の .NET クラスおよびスキーマを使用することもできます。

メッセージ部分は、オーケストレーション内で直接アクセスしたり割り当てたりできます。また、識別フィールドまたはプロパティ フィールドとして公開されている、メッセージ部分の各要素を使用することもできます。 詳細については、「 識別フィールドとメッセージ プロパティの使用」を参照してください。

Note

マルチパート メッセージの種類に含める部分は、複数とは限りません。

Note

メッセージ パーツは、.NET 型 XmlDocument によって定義できます。これは、任意の XML ドキュメントを格納するために使用できます。XML シリアル化可能な任意の .NET 型、またはカスタム シリアル化をサポートする任意の .NET 型によって定義できます。

マルチパート メッセージの種類を追加する

  1. [ オーケストレーション ビュー ] ウィンドウで、[ 種類 ] ノードを展開します。

  2. [ マルチパート メッセージの種類 ] を右クリックし、[ 新しいマルチパート メッセージの種類] をクリックします。

    [マルチパート メッセージの種類] フォルダーは折りたたまれている場合に展開され、新しいマルチパート メッセージの種類が 1 つの既定のメッセージ パーツと共に追加されます。

  3. マルチパート メッセージの種類、および提供されたメッセージ部分に名前を付けます。

    マルチパート メッセージの種類に複数のメッセージ パーツが必要な場合は、新しい>メッセージ パーツに名前を割り当てることで、追加のパーツを<追加できます。

  4. 各メッセージ部分と、.NET クラスまたはスキーマなどの種類を関連付けます。

マルチパート メッセージの種類を削除する

  • [ オーケストレーション ビュー ] ウィンドウで、削除するマルチパート メッセージの種類を右クリックし、[削除] をクリック します。

    Note

    オーケストレーションからマルチパート メッセージの種類を削除すると、これが使用されているメッセージからも種類の情報が削除されます。

    Note

    読み取り専用として表示される項目は、別のオーケストレーションで定義されています。

マルチパート メッセージの種類からパーツを削除する

  • [ オーケストレーション ビュー ] ウィンドウで、削除するパーツを右クリックし、[削除] をクリック します。

    Note

    メッセージ本文パーツ プロパティが true に設定されている場合、メッセージの種類の メッセージ パーツ を削除することはできません。 最初に 、メッセージの種類 の別の部分のメッセージ本文パーツ プロパティを True に設定する必要があります。

マルチパート メッセージ型の型修飾子を設定する

  • [プロパティ] ウィンドウ で 、次のプロパティを設定します。

    プロパティ 説明
    型修飾子 マルチパート メッセージの種類のスコープを設定します。

    - プライベート—このマルチパート メッセージの種類へのアクセスは、含まれているモジュールに制限されます。
    - パブリック—このマルチパート メッセージの種類へのアクセスは制限されません。
    - 内部—このマルチパート メッセージの種類へのアクセスは、同じプロジェクト内のモジュールに制限されます。

既存のマルチパート メッセージにパーツを追加する

  • BizTalk Serverでは、パーツをマルチ パート XLANG メッセージに追加したり、パーツが存在する場合に、最初に宣言されたパーツ数より大きいインデックスでメッセージ パーツを参照したりできます。 この機能は、可変数の添付ファイルを含んだ SMTP メッセージを送信または受信する場合に便利です。 この機能は、次のように実装されます。

  • プロジェクトから、 Microsoft.XLANGs.BaseTypes への参照を追加します。

  • Microsoft.XLANGs.BaseTypes.XLANGMessage 型の変数 (xlangPart など) を作成します。

  • xlangPart を呼び出します。AddPart(...)式図形の適切な引数を使用します。

    Note

    追加されたパーツは XmlDocument 型であるため、 AddPart() メソッドを使用してカスタムの書式設定されたメッセージ パーツを追加することはできません。

Note

宣言されたパーツの数より大きいを含むマルチパート メッセージを受信した場合、オーケストレーション エンジンはメッセージ内のパーツの数を読み取り、宣言されたメッセージの種類のパーツ数に一致するパーツの適切なパーツの種類を構築し、残りの部分の XmlDocument パーツを構築します。

参照

UI ガイダンスと開発者 API 名前空間リファレンスの IBaseMessage.AddPart メソッド (COM)
Web 上の XSD リソース
識別フィールドとプロパティ フィールドの使用
オーケストレーションでのメッセージの使用