XML 汇编程序管道组件中的处理指令

处理指令向处理 XML 文档的应用程序提供信息。 这些信息可能包括有关如何处理文档的说明、如何显示文档等。

处理指令通过 添加处理指令 属性(或消息上下文中的等效 XMLNorm.ProcessingInstructionOption 属性)添加到 XML 文档。 使用 添加处理指令文本 属性(或消息上下文上的等效 XMLNorm.ProcessingInstruction 属性)指定处理指令文本。

Add processing instructions 属性(或 XMLNorm.ProcessingInstructionOption 属性)有三个可能的值,如下表所述。

价值 价值 DESCRIPTION
追加 0 XML 汇编程序的新处理指令将追加到文档开头的处理指令。
新建 1 XML 汇编程序中的新处理指令将覆盖文档开头的现有处理指令。
忽略 2 删除文档开头的处理指令。

在消息上下文中指定的那对处理指令(或消息上下文属性)优先于在管道设计器中指定的属性对。 例如,如果将 XMLNorm.ProcessingInstructionOption 指定为 “新建 ”(1),并且未指定 XMLNorm.ProcessingInstruction ,则空处理指令将替换现有的处理指令。

另一个示例是,如果指定 了 XMLNorm.ProcessingInstruction ,但 XMLNorm.ProcessingInstructionOption 不是,则不会使用消息上下文中的任何属性。 在这种情况下,将使用管道设计器中的处理指令。

默认情况下, 添加处理指令 设置为 “追加”, 添加处理指令文本 为空。

处理属性和信封

由于未保留信封的处理指令,因此平面文件汇编程序设置的以下组合仅导致最外层的信封具有处理指令:

  • 处理指令范围 属性设置为“Envelope”。

  • 将处理指令 属性设置为“追加”。

    信封将使用汇编程序 添加处理指令文本属性中指定的处理指令

    传入消息中指定的外部或内部信封(s)中的任何现有处理指令都不会出现在输出消息中。

另请参阅

XML 汇编程序管道组件
如何配置 XML 汇编程序管道组件
Pipelines-AssemblerDisassembler (BizTalk Server 示例文件夹)