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 示例文件夹）