XML 組合器管線元件中的處理指示
處理指示提供處理 XML 文件之應用程式的資訊。 這類資訊可能包含如何處理文件、如何顯示文件等等的指示。
處理指示會透過在訊息內容) 上 新增處理指示 屬性 (或對等 的 XMLNorm.ProcessingInstructionOption 屬性新增至 XML 檔。 處理指示文字是使用 新增處理指示文字 屬性 (或訊息內容) 的對等 XMLNorm.ProcessingInstruction 屬性來指定。
新增處理指示屬性 (或XMLNorm.ProcessingInstructionOption屬性) 有三個可能的值,如下表所述。
值 | 值 | 描述 |
---|---|---|
附加 | 0 | 來自 XML 組合器的新處理指示會附加至文件開頭的處理指示。 |
建立新項目 | 1 | 來自 XML 組合器的新處理指示會覆寫文件開頭的現有處理指示。 |
忽略 | 2 | 會移除文件開頭的處理指示。 |
在訊息內容上指定之這組處理指示 (或訊息內容屬性) 的優先順序高於在管線設計師中所指定的屬性組。 例如,如果未指定 XMLNorm.ProcessingInstructionOption 做為 Create new (1) ,且 未指定 XMLNorm.ProcessingInstruction ,空的處理指示將會取代現有的處理指示。
另一個範例是指定 XMLNorm.ProcessingInstruction ,但 XMLNorm.ProcessingInstructionOption 不是,則不會使用訊息內容中的任何屬性。 在此種情況下,會使用來自管線設計師的處理指示。
根據預設, [新增處理指示 ] 會設定為 [附加],而 [新增處理指示] 文字 是空的。
處理屬性和信封
因為處理指示並非保留供信封所使用,所以下列一般檔案組合器設定的組合只會導致具有處理指示的最外層信封:
處理指示範圍 屬性設為 「Envelope」。
將處理指示 屬性設定為 「Append」。
信封會使用組合器 [ 新增處理] 指令文字屬性中指定的處理指示 。
任何在外部或內部信封中的現有處理指示 (如指定在內送訊息中) 都不會出現在輸出訊息中。
另請參閱
XML 組合器管線元件
如何設定 XML 組合器管線元件
Pipelines-AssemblerDisassembler (BizTalk Server Samples 資料夾)