Freigeben über


Verarbeitungsanweisungen in der XML-Assemblerpipelinekomponente

Verarbeitungsanweisungen enthalten Informationen für die Anwendung, die ein XML-Dokument verarbeitet. Solche Informationen können Anweisungen zum Verarbeiten des Dokuments, zum Anzeigen des Dokuments usw. enthalten.

Verarbeitungsanweisungen werden einem XML-Dokument durch die Eigenschaft "Verarbeitungsanweisungen hinzufügen " (oder die entsprechende XMLNorm.ProcessingInstructionOption-Eigenschaft im Nachrichtenkontext) hinzugefügt. Die Verarbeitung von Anweisungstext wird mit der Texteigenschaft "Verarbeitungsanweisungen hinzufügen " (oder der entsprechenden XMLNorm.ProcessingInstruction-Eigenschaft im Nachrichtenkontext) angegeben.

Die Eigenschaft "Verarbeitungsanweisungen hinzufügen " (oder "XMLNorm.ProcessingInstructionOption "-Eigenschaft) weist drei mögliche Werte auf, die in der folgenden Tabelle beschrieben werden.

Wert Wert BESCHREIBUNG
Anfügen 0 Neue Verarbeitungsanweisungen aus dem XML-Assembler werden am Anfang des Dokuments an die Verarbeitungsanweisungen angefügt.
Neu erstellen 1 Neue Verarbeitungsanweisungen aus dem XML-Assembler überschreiben vorhandene Verarbeitungsanweisungen am Anfang des Dokuments.
Ignorieren 2 Verarbeitungsanweisungen am Anfang des Dokuments werden entfernt.

Das in einem Nachrichtenkontext angegebene Paar von Verarbeitungsanweisungen (oder Nachrichtenkontexteigenschaften) hat Vorrang vor dem im Pipeline-Designer angegebenen Eigenschaftenpaar. Wenn z. B. XMLNorm.ProcessingInstructionOption als Create new (1) und XMLNorm.ProcessingInstruction nicht angegeben ist, ersetzt eine leere Verarbeitungsanweisung eine vorhandene Verarbeitungsanweisung.

Ein weiteres Beispiel: Wenn XMLNorm.ProcessingInstruction angegeben ist, aber XMLNorm.ProcessingInstructionOption nicht ist, werden keine der Eigenschaften aus dem Nachrichtenkontext verwendet. In diesem Fall werden die Verarbeitungsanweisungen aus dem Pipeline-Designer verwendet.

Standardmäßig ist " Verarbeitungsanweisungen hinzufügen" auf "Anfügen" festgelegt, und Text für das Hinzufügen von Verarbeitungsanweisungen ist leer.

Verarbeiten von Eigenschaften und Umschlägen

Da die Verarbeitungsanweisungen für die Umschläge nicht beibehalten werden, bedeutet die folgende Kombination von Einstellungen des Flachdateiassemblers, dass nur der äußerste Umschlag die Verarbeitungsanweisung enthält.

  • Eigenschaft des Verarbeitungsanweisungenbereichs auf "Envelope" festgelegt.

  • Fügen Sie die Eigenschaft "Verarbeitungsanweisungen" hinzu, die auf "Append" festgelegt ist.

    Der Umschlag würde die verarbeitungsanweisung verwenden, die in der Texteigenschaft "Verarbeitungsanweisungen hinzufügen" des Assemblers angegeben ist.

    Alle vorhandenen Verarbeitungsanweisungen in den äußeren oder inneren Umschlägen, wie in der eingehenden Nachricht angegeben, sind in den Ausgabenachrichten(en) nicht vorhanden.

Siehe auch

XML-Assemblerpipelinekomponente
Konfigurieren der XML-Assemblerpipelinekomponente
Pipelines-AssemblerDisassembler (BizTalk Server Samples Folder)