Beispiel zum Speichern eines XPS-Dokuments

Artikel
01/05/2009

Aktualisiert: November 2007

XpsSave veranschaulicht, wie ein XML Paper Specification (XPS)-Dokument synchron oder asynchron in eine Datei geschrieben wird. Beim Ausführen zeigt das Beispiel die ComboBox "Select Content" an, in der der Benutzer einen von fünf vordefinierten Inhaltstypen auswählen kann: ein visuelles Objekt, mehrere visuelle Objekte, ein Flussdokument, ein einheitlich dargestelltes Dokument oder mehrere einheitlich dargestellte Dokumente. Der ausgewählte Inhalt wird in im rechten Bereich des Anwendungsfensters im DocumentViewer-Steuerelement angezeigt. Nach dem Auswählen des Inhalts werden zwei Druckschaltflächen aktiviert: "Save - Synchronous" und "Save -Asynchronous". Durch das Klicken auf eine der Schaltflächen wird das Dialogfeld "Save As..." geöffnet. Dies initiiert dann das Schreiben des XML Paper Specification (XPS)-Dokuments in eine angegebene Datei.

"Save - Synchronous" zeigt die grundlegenden Funktionen zum Schreiben eines XPS-Dokuments an. Beim synchronen Schreiben wartet die Benutzeroberfläche den Abschluss der Ausgabe ab. Bei kleinen Dokumenten mit kurzer Ausgabedauer stellt das Warten auf den Abschluss des Schreibens kein Problem dar, dies ist jedoch im Allgemeinen nicht empfehlenswert, da der Speichervorgang bei großen Dokumenten längere Zeit in Anspruch nehmen kann.

Bei "Save - Asynchronous" wird die Benutzeroberfläche weiter ausgeführt, während der XPS-Schreibvorgang unabhängig fortgesetzt wird. Für das asynchrone Speichern muss zusätzlicher Code eingerichtet werden, dies ist jedoch die empfohlene Vorgehensweise, um eine reagierende Benutzeroberfläche beizubehalten.

In diesem Beispiel soll nur ein bestimmtes Feature des Windows Presentation Foundation (WPF) veranschaulicht werden, daher werden die bewährten Methoden für die Anwendungsentwicklung nicht befolgt. Ausführliche Informationen über empfohlene Vorgehensweisen bei der Anwendungsentwicklung für Windows Presentation Foundation (WPF) und Microsoft .NET Framework finden Sie unter folgenden Themen:

Eingabehilfen – Bewährte Methoden für Eingabehilfen

Sicherheit – Windows Presentation Foundation-Sicherheit

Lokalisierung – Übersicht über WPF-Globalisierung und -Lokalisierung

Download sample

Erstellen des Beispiels

Installieren Sie das Windows Software Development Kit (SDK) und öffnen Sie dessen Buildumgebungs-Befehlsfenster. Zeigen Sie im Startmenü auf Alle Programme und Microsoft Windows SDK, und klicken Sie dann auf CMD Shell.
Laden Sie das Beispiel, normalerweise aus der Software Development Kit (SDK)-Dokumentation, auf Ihre Festplatte herunter.
Um das Beispiel über das Buildumgebungs-Befehlsfenster zu erstellen, wechseln Sie zum Quellverzeichnis des Beispiels. Geben Sie an der Eingabeaufforderung MSBUILD ein.
Um das Beispiel mit in Microsoft Visual Studio zu erstellen, laden Sie die Projektmappe oder Projektdatei des Beispiels, und drücken Sie STRG+UMSCHALT+B.

Ausführen des Beispiels

Um das kompilierte Beispiel in Visual Studio mit Debuggen auszuführen, drücken Sie F5.
Um das Beispiel über ein CMD Shell-Befehlsfenster auszuführen, führen Sie die EXE-Datei aus, die sich im Quellordner des Beispiels befindet.