Freigeben über


XpsDocumentWriter.WriteAsync Methode

Definition

Schreibt asynchron in das XpsDocument oder die PrintQueue, das bzw. die den XpsDocumentWriter erstellt hat.

Überlädt

WriteAsync(FixedPage, Object)

Schreibt asynchron ein angegebenes FixedPage in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedPage, PrintTicket)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(Visual, Object)

Schreibt asynchron ein angegebenes Visual in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(Visual, PrintTicket)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedDocument, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocument zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedPage, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(Visual, PrintTicket, Object)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedDocumentSequence, PrintTicket)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(DocumentPaginator, PrintTicket, Object)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedDocumentSequence, Object)

Schreibt asynchron ein angegebenes FixedDocumentSequence in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedDocumentSequence)

Schreibt asynchron ein angegebenes FixedDocumentSequence in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedDocument, Object)

Schreibt asynchron ein angegebenes FixedDocument in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(DocumentPaginator, PrintTicket)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(DocumentPaginator, Object)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(String, XpsDocumentNotificationLevel)

Schreibt asynchron ein angegebenes XPS-Dokument mit Benachrichtigungsoption in das Ziel XpsDocument oder PrintQueue.

WriteAsync(Visual)

Schreibt asynchron ein angegebenes Visual in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedPage)

Schreibt asynchron ein angegebenes FixedPage in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedDocument)

Schreibt asynchron ein angegebenes FixedDocument in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(DocumentPaginator)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(String)

Schreibt asynchron ein angegebenes XPS-Dokument in das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocument, PrintTicket)

Schreibt asynchron ein angegebenes FixedDocument zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

WriteAsync(FixedPage, Object)

Schreibt asynchron ein angegebenes FixedPage in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.FixedPage * obj -> unit
Public Overrides Sub WriteAsync (fixedPage As FixedPage, userSuppliedState As Object)

Parameter

fixedPage
FixedPage

Die Seite, die geschrieben wird.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Gilt für:

WriteAsync(FixedPage, PrintTicket)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage, System::Printing::PrintTicket ^ printTicket);
public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket);
override this.WriteAsync : System.Windows.Documents.FixedPage * System.Printing.PrintTicket -> unit
Public Overrides Sub WriteAsync (fixedPage As FixedPage, printTicket As PrintTicket)

Parameter

fixedPage
FixedPage

Die Seite, die geschrieben wird.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für die Seite darstellt.

Hinweise

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die spezifisch für den PrintQueue ist und für einen angegebenen Drucker gültig ist.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Write(FixedPage, PrintTicket).

Gilt für:

WriteAsync(Visual, Object)

Schreibt asynchron ein angegebenes Visual in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Media.Visual visual, object userSuppliedState);
override this.WriteAsync : System.Windows.Media.Visual * obj -> unit
Public Overrides Sub WriteAsync (visual As Visual, userSuppliedState As Object)

Parameter

visual
Visual

Das geschriebene Visual-Objekt.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

Verwenden Sie VisualsToXpsDocument, um ein Batch zu Visualschreiben.

Gilt für:

WriteAsync(Visual, PrintTicket)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual, System::Printing::PrintTicket ^ printTicket);
public override void WriteAsync (System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket);
override this.WriteAsync : System.Windows.Media.Visual * System.Printing.PrintTicket -> unit
Public Overrides Sub WriteAsync (visual As Visual, printTicket As PrintTicket)

Parameter

visual
Visual

Das geschriebene Visual-Objekt.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für das Dokument darstellt.

Hinweise

Verwenden Sie VisualsToXpsDocument, um ein Batch zu Visualschreiben.

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die spezifisch für den PrintQueue ist und für einen angegebenen Drucker gültig ist.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Write(Visual, PrintTicket).

Gilt für:

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence * System.Printing.PrintTicket * obj -> unit
Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, printTicket As PrintTicket, userSuppliedState As Object)

Parameter

fixedDocumentSequence
FixedDocumentSequence

Der Satz von Dokumenten, die geschrieben werden sollen.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für den Satz von Dokumenten darstellt.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

WriteAsyncschreibt eine Gruppe von Dokumenten asynchron in die oder , die XpsDocument erstellt hatXpsDocumentWriter.PrintQueue Die geschriebenen Daten enthalten eine PrintTicket - und zusätzliche Informationen, die der Aufrufer an einen Ereignishandler übergeben möchte.

Obwohl die XpsDocument Klasse einen einzelnen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt der vorhandenen Sequenz ein FixedDocument oder einen Satz von FixedDocument Elementen hinzu.

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die spezifisch für den PrintQueue ist und für einen angegebenen Drucker gültig ist.

Gilt für:

WriteAsync(FixedDocument, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocument zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.FixedDocument * System.Printing.PrintTicket * obj -> unit
Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, printTicket As PrintTicket, userSuppliedState As Object)

Parameter

fixedDocument
FixedDocument

Das Dokument, das geschrieben wird.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für das Dokument darstellt.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

Obwohl die XpsDocument Klasse einen einzelnen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem Satz einen hinzu FixedDocument .

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die spezifisch für den PrintQueue ist und für einen angegebenen Drucker gültig ist.

Gilt für:

WriteAsync(FixedPage, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.FixedPage * System.Printing.PrintTicket * obj -> unit
Public Overrides Sub WriteAsync (fixedPage As FixedPage, printTicket As PrintTicket, userSuppliedState As Object)

Parameter

fixedPage
FixedPage

Die Seite, die geschrieben wird.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für die Seite darstellt.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die spezifisch für den PrintQueue ist und für einen angegebenen Drucker gültig ist.

Gilt für:

WriteAsync(Visual, PrintTicket, Object)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket, object userSuppliedState);
override this.WriteAsync : System.Windows.Media.Visual * System.Printing.PrintTicket * obj -> unit
Public Overrides Sub WriteAsync (visual As Visual, printTicket As PrintTicket, userSuppliedState As Object)

Parameter

visual
Visual

Das geschriebene Visual-Objekt.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für das Dokument darstellt.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

Verwenden Sie VisualsToXpsDocumentzum Schreiben mehrerer Visual Elemente .

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die für den PrintQueue und für einen angegebenen Drucker gültig ist.

Gilt für:

WriteAsync(FixedDocumentSequence, PrintTicket)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Printing::PrintTicket ^ printTicket);
public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket);
override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence * System.Printing.PrintTicket -> unit
Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, printTicket As PrintTicket)

Parameter

fixedDocumentSequence
FixedDocumentSequence

Der Satz von Dokumenten, die geschrieben werden.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für den Satz von Dokumenten darstellt.

Hinweise

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem vorhandenen Satz ein FixedDocument oder einen Satz von FixedDocument Elementen hinzu.

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die für den PrintQueue und für einen angegebenen Drucker gültig ist.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(FixedDocumentSequence, PrintTicket)Ausnahmen.

Gilt für:

WriteAsync(DocumentPaginator, PrintTicket, Object)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.DocumentPaginator * System.Printing.PrintTicket * obj -> unit
Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, printTicket As PrintTicket, userSuppliedState As Object)

Parameter

documentPaginator
DocumentPaginator

Ein Objekt, das einen Zeiger auf nicht paginiertes Quellmaterial und außerdem Methoden zum Paginieren des Materials enthält.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für das Material darstellt.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die für den PrintQueue und für einen angegebenen Drucker gültig ist.

Gilt für:

WriteAsync(FixedDocumentSequence, Object)

Schreibt asynchron ein angegebenes FixedDocumentSequence in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence * obj -> unit
Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, userSuppliedState As Object)

Parameter

fixedDocumentSequence
FixedDocumentSequence

Der Satz von Dokumenten, die geschrieben werden.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem vorhandenen Satz ein FixedDocument oder einen Satz von FixedDocument Elementen hinzu.

Gilt für:

WriteAsync(FixedDocumentSequence)

Schreibt asynchron ein angegebenes FixedDocumentSequence in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence);
public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence);
override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence -> unit
Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence)

Parameter

fixedDocumentSequence
FixedDocumentSequence

Der Satz von Dokumenten, der geschrieben wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um in ein XPS-Dokument zu schreiben.

private void SaveMultipleFixedContentDocumentsAsync(
             XpsDocumentWriter xpsdw, FixedDocumentSequence fds)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    xpsdw.WritingProgressChanged +=
        new WritingProgressChangedEventHandler(AsyncSavingProgress);

    // Write the FixedDocumentSequence as a
    // collection of documents asynchronously.
    xpsdw.WriteAsync(fds);
}
Private Sub SaveMultipleFixedContentDocumentsAsync(ByVal xpsdw As XpsDocumentWriter, ByVal fds As FixedDocumentSequence)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    AddHandler xpsdw.WritingProgressChanged, AddressOf AsyncSavingProgress

    ' Write the FixedDocumentSequence as a
    ' collection of documents asynchronously.
    xpsdw.WriteAsync(fds)
End Sub

Hinweise

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem vorhandenen Satz ein FixedDocument oder einen Satz von FixedDocument Elementen hinzu.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(FixedDocumentSequence)Ausnahmen.

Gilt für:

WriteAsync(FixedDocument, Object)

Schreibt asynchron ein angegebenes FixedDocument in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.FixedDocument * obj -> unit
Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, userSuppliedState As Object)

Parameter

fixedDocument
FixedDocument

Das Dokument, das geschrieben wird.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Hinweise

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem Satz ein hinzu FixedDocument .

Gilt für:

WriteAsync(DocumentPaginator, PrintTicket)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Printing::PrintTicket ^ printTicket);
public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket);
override this.WriteAsync : System.Windows.Documents.DocumentPaginator * System.Printing.PrintTicket -> unit
Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, printTicket As PrintTicket)

Parameter

documentPaginator
DocumentPaginator

Ein Objekt, das einen Zeiger auf nicht paginiertes Quellmaterial und außerdem Methoden zum Paginieren des Materials enthält.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für das Material darstellt.

Hinweise

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die für den PrintQueue und für einen angegebenen Drucker gültig ist.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(DocumentPaginator, PrintTicket)Ausnahmen.

Gilt für:

WriteAsync(DocumentPaginator, Object)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Object ^ userSuppliedState);
public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, object userSuppliedState);
override this.WriteAsync : System.Windows.Documents.DocumentPaginator * obj -> unit
Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, userSuppliedState As Object)

Parameter

documentPaginator
DocumentPaginator

Ein Objekt, das einen Zeiger auf nicht paginiertes Quellmaterial und außerdem Methoden zum Paginieren des Materials enthält.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt, mit dem der asynchrone Vorgang bestimmt und das diesem zugeordnet werden soll.

Gilt für:

WriteAsync(String, XpsDocumentNotificationLevel)

Schreibt asynchron ein angegebenes XPS-Dokument mit Benachrichtigungsoption in das Ziel XpsDocument oder PrintQueue.

public:
 void WriteAsync(System::String ^ documentPath, System::Windows::Xps::XpsDocumentNotificationLevel notificationLevel);
public void WriteAsync (string documentPath, System.Windows.Xps.XpsDocumentNotificationLevel notificationLevel);
override this.WriteAsync : string * System.Windows.Xps.XpsDocumentNotificationLevel -> unit
Public Sub WriteAsync (documentPath As String, notificationLevel As XpsDocumentNotificationLevel)

Parameter

documentPath
String

Der Pfad des Quelldokuments.

notificationLevel
XpsDocumentNotificationLevel

Ein Hinweis darauf, ob die Benachrichtigung aktiviert ist.

Hinweise

Wenn notificationLevel deaktiviert ist, kopiert das XpsDocumentWriter serialisierte XPS-Dokument in das Ziel XpsDocument oder PrintQueue , das erstellt XpsDocumentWriterhat. Wenn notificationLevel aktiviert ist, deserialisiert die XpsDocumentWriter erste deserialisiert das Dokument, als nächstes ändert es es und schreibt es dann mit Statusbenachrichtigungen in das Ziel, während jede Seite ausgegeben wird.

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt die FixedDocument Elemente in der Quelle der Sequenz der FixedDocument Elemente im Ziel XpsDocument oder PrintQueuehinzu.

Wenn notificationLevel als ReceiveNotificationEnabledangegeben wird, werden Benachrichtigungen nur erstellt, wenn das Dokument serialisiert und nicht gedruckt wird. Zum Empfangen von Benachrichtigungen muss das Dokument neu initialisiert werden. Wenn ein Dokument neu formatiert wird, werden alle Inhalte aus dem entfernt, die Package nicht von der XML-Papierspezifikation beibehalten werden müssen. Die Reserialisierung entfernt auch alle Erweiterungen aus dem FixedPage Markup, einschließlich aller erweiterten XPS-Inhalte.

Wenn notificationLevel angegeben ist, dass ReceiveNotificationDisabled das Dokument nicht neu initialisiert wird und alle erweiterten Inhalte beibehalten werden, auch wenn sie gedruckt werden.

Standardmäßig ruft diese WriteAsync Methode das WritingPrintTicketRequired Ereignis nicht auf.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(String, XpsDocumentNotificationLevel)Ausnahmen.

Gilt für:

WriteAsync(Visual)

Schreibt asynchron ein angegebenes Visual in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual);
public override void WriteAsync (System.Windows.Media.Visual visual);
override this.WriteAsync : System.Windows.Media.Visual -> unit
Public Overrides Sub WriteAsync (visual As Visual)

Parameter

visual
Visual

Das geschriebene Visual-Objekt.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um ein in Visual ein XPS-Dokument zu schreiben.

private void SaveVisualAsync(XpsDocumentWriter xpsdw, Visual v)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    xpsdw.WriteAsync(v);    // Write visual to single page.
}
Private Sub SaveVisualAsync(ByVal xpsdw As XpsDocumentWriter, ByVal v As Visual)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    xpsdw.WriteAsync(v) ' Write visual to single page.
End Sub

Hinweise

Verwenden Sie VisualsToXpsDocument, um einen Batch zu Visualschreiben.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(Visual)Ausnahmen.

Gilt für:

WriteAsync(FixedPage)

Schreibt asynchron ein angegebenes FixedPage in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage);
public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage);
override this.WriteAsync : System.Windows.Documents.FixedPage -> unit
Public Overrides Sub WriteAsync (fixedPage As FixedPage)

Parameter

fixedPage
FixedPage

Die Seite, die geschrieben wird.

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(FixedPage)Ausnahmen.

Gilt für:

WriteAsync(FixedDocument)

Schreibt asynchron ein angegebenes FixedDocument in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument);
public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument);
override this.WriteAsync : System.Windows.Documents.FixedDocument -> unit
Public Overrides Sub WriteAsync (fixedDocument As FixedDocument)

Parameter

fixedDocument
FixedDocument

Das Dokument, das geschrieben wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um in ein XPS-Dokument zu schreiben.

private void SaveSingleFixedContentDocumentAsync(
             XpsDocumentWriter xpsdw, FixedDocument fd)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the FixedDocument as a document.
    xpsdw.WriteAsync(fd);
}
Private Sub SaveSingleFixedContentDocumentAsync(ByVal xpsdw As XpsDocumentWriter, ByVal fd As FixedDocument)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    ' Write the FixedDocument as a document.
    xpsdw.WriteAsync(fd)
End Sub

Hinweise

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem Satz ein hinzu FixedDocument .

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(FixedDocument)Ausnahmen.

Gilt für:

WriteAsync(DocumentPaginator)

Schreibt asynchron paginierten Inhalt aus einem angegebenen DocumentPaginator in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator);
public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator);
override this.WriteAsync : System.Windows.Documents.DocumentPaginator -> unit
Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator)

Parameter

documentPaginator
DocumentPaginator

Ein Objekt, das einen Zeiger auf nicht paginiertes Quellmaterial und außerdem Methoden zum Paginieren des Materials enthält.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um in ein XPS-Dokument zu schreiben.

private void SaveSingleFlowContentDocumentAsync(
             XpsDocumentWriter xpsdw, DocumentPaginator idp)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the IDP as a document.
    xpsdw.WriteAsync(idp);
}
Private Sub SaveSingleFlowContentDocumentAsync(ByVal xpsdw As XpsDocumentWriter, ByVal idp As DocumentPaginator)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    ' Write the IDP as a document.
    xpsdw.WriteAsync(idp)
End Sub

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(DocumentPaginator)Ausnahmen.

Gilt für:

WriteAsync(String)

Schreibt asynchron ein angegebenes XPS-Dokument in das Ziel XpsDocument oder PrintQueue.

public:
 void WriteAsync(System::String ^ documentPath);
public void WriteAsync (string documentPath);
override this.WriteAsync : string -> unit
Public Sub WriteAsync (documentPath As String)

Parameter

documentPath
String

Der Pfad des Quelldokuments.

Hinweise

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt die FixedDocument Elemente in der Quelle dem Satz von FixedDocument Elementen im Ziel XpsDocument oder PrintQueuehinzu.

Mit dieser WriteAsync Methode wird das angegebene XPS-Dokument neu formatiert, wodurch alle Inhalte aus dem entfernt werden, der Package nicht von der XML-Papierspezifikation beibehalten werden muss. Die Reserialisierung entfernt auch alle Erweiterungen aus dem FixedPage Markup, einschließlich aller erweiterten XPS-Inhalte.

Standardmäßig ruft diese WriteAsync Methode das WritingPrintTicketRequired Ereignis nicht auf.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(String)Ausnahmen.

Gilt für:

WriteAsync(FixedDocument, PrintTicket)

Schreibt asynchron ein angegebenes FixedDocument zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die PrintQueue.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Printing::PrintTicket ^ printTicket);
public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket);
override this.WriteAsync : System.Windows.Documents.FixedDocument * System.Printing.PrintTicket -> unit
Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, printTicket As PrintTicket)

Parameter

fixedDocument
FixedDocument

Das Dokument, das geschrieben wird.

printTicket
PrintTicket

Ein PrintTicket, das die Standarddruckeinstellungen für das Dokument darstellt.

Hinweise

Obwohl die XpsDocument Klasse einen singularen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem Satz ein hinzu FixedDocument .

Diese Methode überprüft oder ändert nicht die für printTicket eine bestimmte PrintQueue. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket -Methode, um eine PrintTicket zu erstellen, die für den PrintQueue und für einen angegebenen Drucker gültig ist.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Write(FixedDocument, PrintTicket)Ausnahmen.

Gilt für: