共用方式為


如何使用多部分訊息類型

每個訊息都有多部分訊息類型,即是由零或多個訊息部分所組成的訊息的結構描述。 這些部分是由 XML 結構描述定義 (XSD) 語言結構描述或 .NET 類別所定義。 您可以定義自己的多部分訊息類型,也可以使用現有的 .NET 類別和結構描述。

您可以直接在協調流程內存取或指派訊息部分,也可以使用公開為辨別欄位或屬性欄位的個別訊息部分項目。 如需詳細資訊,請參閱 使用辨別欄位和訊息屬性

注意

多部分訊息類型不一定要包含多個部分。

注意

訊息元件可由 .NET 類型 XmlDocument定義,此類型可用來包含任意 XML 檔、可序列化 XML 的任何 .NET 類型,或是支援自訂序列化的任何 .NET 類型。

新增多部分訊息類型

  1. 在 [ 協調流程檢視] 視窗中,展開 [ 類型] 節點。

  2. 以滑鼠右鍵按一下 [多部分訊息類型 ],然後按一下 [ 新增多部分訊息類型]。

    如果折迭,則會展開 [多部分訊息類型 ] 資料夾,並新增含有一個預設訊息部分的新多部分訊息類型。

  3. 命名多部分訊息類型和提供的訊息部分。

    如果您的多部分訊息類型需要多個訊息元件,您可以將名稱指派給新增 > 訊息元件, < 以新增其他元件。

  4. 將每個訊息部分與類型 (例如,.NET 類別或結構描述) 建立關聯。

移除多部分訊息類型

  • 在 [ 協調流程檢視 ] 視窗中,以滑鼠右鍵按一下您想要移除的多部分訊息類型,然後按一下 [ 刪除]。

    注意

    從協調流程移除多部分訊息類型,也會從用到它的訊息中移除類型資訊。

    注意

    顯示為唯讀的項目定義在另一個協調流程中。

從多部分訊息類型中移除元件

  • 在 [ 協調流程檢視 ] 視窗中,以滑鼠右鍵按一下您想要移除的元件,然後按一下 [ 刪除]。

    注意

    如果 訊息本文元件 屬性設定為 true,則無法刪除訊息類型的訊息部分。 您必須先將 訊息本文元件 屬性設定為 True,才能讓另一個訊息類型的元件設定為 True。

設定多部分訊息類型的類型修飾詞

  • 在 [ 屬性] 視窗中,設定下列屬性:

    屬性 Description
    類型修飾詞 決定多部分訊息類型的範圍:

    - 私人—此多部分訊息類型的存取權僅限於包含的模組。
    - 公用—此多部分訊息類型的存取權不受限制。
    - 內部—此多部分訊息類型的存取權僅限於相同專案中的模組。

將元件新增至現有的多部分訊息

  • BizTalk Server可讓您將元件新增至多部分 XLANG 訊息,而且如果元件存在,也可以透過索引來參考訊息元件,其索引大於原先宣告的元件數目。 傳送或接收夾帶數目不定之附件的 SMTP 訊息時,此功能可能會很有用。 實作此功能的方法如下:

  • 從專案新增 Microsoft.XLANGs.BaseTypes 的參考。

  • 建立變數 (例如Microsoft.XLANGs.BaseTypes.XLANGMessage類型的xlangPart) 。

  • 呼叫 xlangPart。AddPart (...) 使用運算式圖形的適當引數。

    注意

    新增的元件的類型為 XmlDocument ,因此您無法使用 AddPart () 方法新增自訂格式化的訊息元件。

注意

如果收到包含大於宣告元件數目的多部分訊息,協調流程引擎會讀取訊息中有多少部分,然後為符合宣告訊息類型中元件數目的元件建構適當的元件類型,然後建構其餘部分的 XmlDocument 元件。

另請參閱

UI 指引和開發人員 API 命名空間參考中的IBaseMessage.AddPart 方法 (COM)
Web 上的 XSD 資源
使用辨別欄位和屬性欄位
在協調流程中使用訊息