XpsDocumentWriter.WriteAsync Methode

Definition

Schreibt asynchron in die XpsDocument oder PrintQueue die das XpsDocumentWritererstellt hat.

Überlädt

Name Beschreibung
WriteAsync(FixedPage, Object)

Schreibt asynchron einen angegebenen FixedPage Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedPage, PrintTicket)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(Visual, Object)

Schreibt asynchron einen angegebenen Visual Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(Visual, PrintTicket)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocument, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocument zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedPage, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(Visual, PrintTicket, Object)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocumentSequence, PrintTicket)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(DocumentPaginator, PrintTicket, Object)

Schreibt asynchron paginierte Inhalte aus einem angegebenen DocumentPaginator Zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocumentSequence, Object)

Schreibt asynchron einen angegebenen FixedDocumentSequence Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocumentSequence)

Schreibt asynchron einen angegebenen FixedDocumentSequence Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocument, Object)

Schreibt asynchron einen angegebenen FixedDocument Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(DocumentPaginator, PrintTicket)

Schreibt asynchron paginierte Inhalte aus einem angegebenen DocumentPaginator Zusammen mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

WriteAsync(DocumentPaginator, Object)

Schreibt asynchron paginierte Inhalte von einem angegebenen DocumentPaginator in das Ziel XpsDocument oder PrintQueue.

WriteAsync(String, XpsDocumentNotificationLevel)

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

WriteAsync(Visual)

Schreibt asynchron einen angegebenen Visual Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedPage)

Schreibt asynchron einen angegebenen FixedPage Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedDocument)

Schreibt asynchron einen angegebenen FixedDocument Wert in das Ziel XpsDocument oder PrintQueue.

WriteAsync(DocumentPaginator)

Schreibt asynchron paginierte Inhalte von einem angegebenen DocumentPaginator in das Ziel XpsDocument oder 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 an das Ziel XpsDocument oder PrintQueue.

WriteAsync(FixedPage, Object)

Schreibt asynchron einen angegebenen FixedPage Wert in das Ziel XpsDocument oder 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 Geschriebene Seite.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Gilt für:

WriteAsync(FixedPage, PrintTicket)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 Geschriebene Seite.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the page.

Hinweise

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(FixedPage, PrintTicket).

Gilt für:

WriteAsync(Visual, Object)

Schreibt asynchron einen angegebenen Visual Wert in das Ziel XpsDocument oder 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 Visual ist geschrieben.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

Verwenden Sie Visualzum Schreiben eines Batches ein VisualsToXpsDocument.

Gilt für:

WriteAsync(Visual, PrintTicket)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 Visual ist geschrieben.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the document.

Hinweise

Verwenden Sie Visualzum Schreiben eines Batches ein VisualsToXpsDocument.

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(Visual, PrintTicket).

Gilt für:

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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

Die Gruppe der zu schreibenden Dokumente.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the set of documents.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

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

Obwohl die XpsDocument Klasse einen Singularnamen hat, kann es XpsDocument sich um FixedDocument einen oder mehrere Dokumente handeln. Diese Methode fügt der vorhandenen Sequenz eine FixedDocument oder mehrere FixedDocument Elemente hinzu.

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Gilt für:

WriteAsync(FixedDocument, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedDocument zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 wurde.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the document.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

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

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Gilt für:

WriteAsync(FixedPage, PrintTicket, Object)

Schreibt asynchron ein angegebenes FixedPage zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 Geschriebene Seite.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the page.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Gilt für:

WriteAsync(Visual, PrintTicket, Object)

Schreibt asynchron ein angegebenes Visual zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 Visual ist geschrieben.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the document.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

Verwenden Sie Visualzum Schreiben mehrerer VisualsToXpsDocument Elemente .

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Gilt für:

WriteAsync(FixedDocumentSequence, PrintTicket)

Schreibt asynchron ein angegebenes FixedDocumentSequence zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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

Die Gruppe der Dokumente, die geschrieben wurden.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the set of documents.

Hinweise

Obwohl die XpsDocument Klasse einen Singularnamen hat, kann es XpsDocument sich um FixedDocument einen oder mehrere Dokumente handeln. Diese Methode fügt dem vorhandenen Satz eine FixedDocument oder mehrere FixedDocument Elemente hinzu.

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(FixedDocumentSequence, PrintTicket).

Gilt für:

WriteAsync(DocumentPaginator, PrintTicket, Object)

Schreibt asynchron paginierte Inhalte aus einem angegebenen DocumentPaginator Zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 entpaginiertes Quellmaterial enthält; enthält auch Methoden zum Auslagerungen des Materials.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the material.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Gilt für:

WriteAsync(FixedDocumentSequence, Object)

Schreibt asynchron einen angegebenen FixedDocumentSequence Wert in das Ziel XpsDocument oder 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

Die Gruppe der Dokumente, die geschrieben wurden.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

Obwohl die XpsDocument Klasse einen Singularnamen hat, kann es XpsDocument sich um FixedDocument einen oder mehrere Dokumente handeln. Diese Methode fügt dem vorhandenen Satz eine FixedDocument oder mehrere FixedDocument Elemente hinzu.

Gilt für:

WriteAsync(FixedDocumentSequence)

Schreibt asynchron einen angegebenen FixedDocumentSequence Wert in das Ziel XpsDocument oder 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

Die Dokumentenmappe, die 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 Singularnamen hat, kann es XpsDocument sich um FixedDocument einen oder mehrere Dokumente handeln. Diese Methode fügt dem vorhandenen Satz eine FixedDocument oder mehrere FixedDocument Elemente hinzu.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(FixedDocumentSequence).

Gilt für:

WriteAsync(FixedDocument, Object)

Schreibt asynchron einen angegebenen FixedDocument Wert in das Ziel XpsDocument oder 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 wurde.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Hinweise

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

Gilt für:

WriteAsync(DocumentPaginator, PrintTicket)

Schreibt asynchron paginierte Inhalte aus einem angegebenen DocumentPaginator Zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 entpaginiertes Quellmaterial enthält und auch Methoden zum Auslagerungen des Materials enthält.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the material.

Hinweise

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(DocumentPaginator, PrintTicket).

Gilt für:

WriteAsync(DocumentPaginator, Object)

Schreibt asynchron paginierte Inhalte von einem angegebenen DocumentPaginator in das Ziel XpsDocument oder 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 entpaginiertes Quellmaterial enthält; enthält auch Methoden zum Auslagerungen des Materials.

userSuppliedState
Object

Ein vom Benutzer angegebenes Objekt zum Identifizieren und Zuordnen des asynchronen Vorgangs.

Gilt für:

WriteAsync(String, XpsDocumentNotificationLevel)

Schreibt asynchron ein angegebenes XPS-Dokument mit Benachrichtigungsoption auf 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 diese Option deaktiviert ist, kopiert das XpsDocumentWriter serialisierte XPS-Dokument in das Ziel oder XpsDocument die das Ziel PrintQueue erstellt hatXpsDocumentWriter. Wenn notificationLevel diese Option aktiviert ist, wird das XpsDocumentWriter Dokument zuerst deserialisiert, die nächste Reserialisierung des Dokuments durchgeführt, und es wird dann mit Statusbenachrichtigungen in das Ziel geschrieben, während jede Seite ausgegeben wird.

Obwohl die XpsDocument Klasse einen Singularnamen hat, kann es XpsDocument sich um FixedDocument einen oder mehrere Dokumente handeln. Diese Methode fügt die FixedDocument Elemente in der Quelle der Abfolge von FixedDocument Elementen im Ziel XpsDocument oder PrintQueue.

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

Wenn notificationLevel als ReceiveNotificationDisabled Dokument angegeben wird, wird die Größe des Dokuments nicht geändert, und alle erweiterten Inhalte bleiben erhalten, auch wenn sie gedruckt werden.

WriteAsync Diese Methode ruft das WritingPrintTicketRequired Ereignis standardmäßig nicht auf.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(String, XpsDocumentNotificationLevel).

Gilt für:

WriteAsync(Visual)

Schreibt asynchron einen angegebenen Visual Wert in das Ziel XpsDocument oder 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 Visual ist geschrieben.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um ein Visual 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 Visualzum Schreiben eines Batches ein VisualsToXpsDocument.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(Visual).

Gilt für:

WriteAsync(FixedPage)

Schreibt asynchron einen angegebenen FixedPage Wert in das Ziel XpsDocument oder 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 Geschriebene Seite.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(FixedPage).

Gilt für:

WriteAsync(FixedDocument)

Schreibt asynchron einen angegebenen FixedDocument Wert in das Ziel XpsDocument oder 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 wurde.

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 Singularnamen hat, kann es XpsDocument sich um FixedDocument einen oder mehrere Dokumente handeln. Diese Methode fügt dem Satz einen hinzu FixedDocument .

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(FixedDocument).

Gilt für:

WriteAsync(DocumentPaginator)

Schreibt asynchron paginierte Inhalte von einem angegebenen DocumentPaginator in das Ziel XpsDocument oder 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 entpaginiertes Quellmaterial enthält und auch Methoden zum Auslagerungen 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 alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(DocumentPaginator).

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 Singularnamen hat, kann es XpsDocument sich um FixedDocument einen oder mehrere Dokumente handeln. Diese Methode fügt die FixedDocument Elemente in der Quelle der Gruppe von FixedDocument Elementen im Ziel XpsDocument oder PrintQueue.

Diese WriteAsync Methode ändert die Größe des angegebenen XPS-Dokuments, das alle Inhalte aus dem nicht für die PackageXML-Papierspezifikation erforderlichen Inhalt entfernt. 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 alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(String).

Gilt für:

WriteAsync(FixedDocument, PrintTicket)

Schreibt asynchron ein angegebenes FixedDocument zusammen mit einem PrintTicket an das Ziel XpsDocument oder 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 wurde.

printTicket
PrintTicket

A PrintTicket that represents the default printing preferences for the document.

Hinweise

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

Diese Methode überprüft oder ändert die angegebene printTicket Eigenschaft für eine bestimmte Methode PrintQueuenicht. Verwenden Sie bei Bedarf die MergeAndValidatePrintTicket Methode, um ein PrintTicket spezifisches Element für einen PrintQueue angegebenen Drucker zu erstellen und gültig zu sein.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(FixedDocument, PrintTicket).

Gilt für: