XpsDocumentWriter.Write Methode

Definition

Überlädt

Name Beschreibung
Write(Visual, PrintTicket)

Schreibt synchron einen angegebenen Visual Wert mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

Write(FixedPage, PrintTicket)

Schreibt synchron einen angegebenen FixedPage Wert mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

Write(FixedDocumentSequence, PrintTicket)

Schreibt synchron einen angegebenen FixedDocumentSequence Wert mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

Write(FixedDocument, PrintTicket)

Schreibt synchron mit FixedDocument einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

Write(String, XpsDocumentNotificationLevel)

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

Write(DocumentPaginator, PrintTicket)

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

Write(FixedPage)

Schreibt synchron einen angegebenen FixedPage Wert für das Ziel XpsDocument oder PrintQueue.

Write(FixedDocumentSequence)

Schreibt synchron einen angegebenen FixedDocumentSequence Wert für das Ziel XpsDocument oder PrintQueue.

Write(FixedDocument)

Schreibt synchron einen angegebenen FixedDocument Wert für das Ziel XpsDocument oder PrintQueue.

Write(DocumentPaginator)

Schreibt synchron aus paginierten Inhalten von einem angegebenen DocumentPaginator in das Ziel XpsDocument oder PrintQueue.

Write(String)

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

Write(Visual)

Schreibt synchron einen angegebenen Visual Wert für das Ziel XpsDocument oder PrintQueue.

Write(Visual, PrintTicket)

Schreibt synchron einen angegebenen Visual Wert mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

public:
 override void Write(System::Windows::Media::Visual ^ visual, System::Printing::PrintTicket ^ printTicket);
public override void Write(System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket);
override this.Write : System.Windows.Media.Visual * System.Printing.PrintTicket -> unit
Public Overrides Sub Write (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.

Gilt für:

Write(FixedPage, PrintTicket)

Schreibt synchron einen angegebenen FixedPage Wert mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

public:
 override void Write(System::Windows::Documents::FixedPage ^ fixedPage, System::Printing::PrintTicket ^ printTicket);
public override void Write(System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket);
override this.Write : System.Windows.Documents.FixedPage * System.Printing.PrintTicket -> unit
Public Overrides Sub Write (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.

Gilt für:

Write(FixedDocumentSequence, PrintTicket)

Schreibt synchron einen angegebenen FixedDocumentSequence Wert mit einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

public:
 override void Write(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Printing::PrintTicket ^ printTicket);
public override void Write(System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket);
override this.Write : System.Windows.Documents.FixedDocumentSequence * System.Printing.PrintTicket -> unit
Public Overrides Sub Write (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.

Gilt für:

Write(FixedDocument, PrintTicket)

Schreibt synchron mit FixedDocument einem PrintTicket an das Ziel XpsDocument oder PrintQueue.

public:
 override void Write(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Printing::PrintTicket ^ printTicket);
public override void Write(System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket);
override this.Write : System.Windows.Documents.FixedDocument * System.Printing.PrintTicket -> unit
Public Overrides Sub Write (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.

Gilt für:

Write(String, XpsDocumentNotificationLevel)

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

public:
 void Write(System::String ^ documentPath, System::Windows::Xps::XpsDocumentNotificationLevel notificationLevel);
public void Write(string documentPath, System.Windows.Xps.XpsDocumentNotificationLevel notificationLevel);
override this.Write : string * System.Windows.Xps.XpsDocumentNotificationLevel -> unit
Public Sub Write (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 serialisierteXPS-Dokument an 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. Um Benachrichtigungen zu empfangen, muss das Dokument erneut initialisiert werden. Wenn ein Dokument erneut initialisiert wird, wird der gesamte Inhalt, der Package nicht von der XML Paper Specification (XPS) beibehalten werden muss, 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.

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

Gilt für:

Write(DocumentPaginator, PrintTicket)

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

public:
 override void Write(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Printing::PrintTicket ^ printTicket);
public override void Write(System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket);
override this.Write : System.Windows.Documents.DocumentPaginator * System.Printing.PrintTicket -> unit
Public Overrides Sub Write (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 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.

Gilt für:

Write(FixedPage)

Schreibt synchron einen angegebenen FixedPage Wert für das Ziel XpsDocument oder PrintQueue.

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

Parameter

fixedPage
FixedPage

Eine Seite, die in die XpsDocumentDatei geschrieben wird.

Gilt für:

Write(FixedDocumentSequence)

Schreibt synchron einen angegebenen FixedDocumentSequence Wert für das Ziel XpsDocument oder PrintQueue.

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

Parameter

fixedDocumentSequence
FixedDocumentSequence

Eine Gruppe von Dokumenten, die in das XpsDocumentDokument geschrieben wird.

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie die Write Methode verwenden, um eine Abfolge von XPS-Dokumenten zu schreiben.

private void SaveMultipleFixedContentDocuments(
             XpsDocumentWriter xpsdw, FixedDocumentSequence fds)
{
    // Write the FixedDocumentSequence as a collection of documents
    xpsdw.Write(fds);
}
Private Sub SaveMultipleFixedContentDocuments(ByVal xpsdw As XpsDocumentWriter, ByVal fds As FixedDocumentSequence)
    ' Write the FixedDocumentSequence as a collection of documents
    xpsdw.Write(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.

Gilt für:

Write(FixedDocument)

Schreibt synchron einen angegebenen FixedDocument Wert für das Ziel XpsDocument oder PrintQueue.

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

Parameter

fixedDocument
FixedDocument

Ein Dokument, das in das XpsDocumentDokument geschrieben wird.

Beispiele

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

private void SaveSingleFixedContentDocument(
             XpsDocumentWriter xpsdw, FixedDocument fd)
{
    xpsdw.Write(fd);        // Write the FixedDocument as a document.
}
Private Sub SaveSingleFixedContentDocument(ByVal xpsdw As XpsDocumentWriter, ByVal fd As FixedDocument)
    xpsdw.Write(fd) ' Write the FixedDocument as a document.
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 .

Gilt für:

Write(DocumentPaginator)

Schreibt synchron aus paginierten Inhalten von einem angegebenen DocumentPaginator in das Ziel XpsDocument oder PrintQueue.

public:
 override void Write(System::Windows::Documents::DocumentPaginator ^ documentPaginator);
public override void Write(System.Windows.Documents.DocumentPaginator documentPaginator);
override this.Write : System.Windows.Documents.DocumentPaginator -> unit
Public Overrides Sub Write (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

Im folgenden Beispiel wird gezeigt, wie Die Methode zum Schreiben in ein XPS-Dokument verwendet Write wird.

private void SaveSingleFlowContentDocument(
             XpsDocumentWriter xpsdw, DocumentPaginator docPaginator)
{
    xpsdw.Write(docPaginator); // Write the DocPaginator as a document.
}
Private Sub SaveSingleFlowContentDocument(ByVal xpsdw As XpsDocumentWriter, ByVal docPaginator As DocumentPaginator)
    xpsdw.Write(docPaginator) ' Write the DocPaginator as a document.
End Sub

Gilt für:

Write(String)

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

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

Parameter

documentPath
String

Der Pfad des Quelldokuments.

Hinweise

Obwohl die XpsDocumentWriter Klasse einen Singularnamen hat, kann es XpsDocumentWriter 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 XpsDocumentWriter oder PrintQueue.

Diese Write Methode ändert die Größe des angegebenen XPS-Dokuments. Dadurch werden alle Inhalte 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.

Standardmäßig löst diese Write Methode das WritingPrintTicketRequired Ereignis nicht aus.

Gilt für:

Write(Visual)

Schreibt synchron einen angegebenen Visual Wert für das Ziel XpsDocument oder PrintQueue.

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

Parameter

visual
Visual

Das Visual ist geschrieben.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie die Write Methode verwenden, um ein Visual XPS-Dokument in ein XPS-Dokument zu schreiben.

private void SaveVisual(XpsDocumentWriter xpsdw, Visual v)
{
    xpsdw.Write(v); // Write visual to single page
}
Private Sub SaveVisual(ByVal xpsdw As XpsDocumentWriter, ByVal v As Visual)
    xpsdw.Write(v) ' Write visual to single page
End Sub

Hinweise

Verwenden Sie Visualzum Schreiben eines Batches ein VisualsToXpsDocument.

Gilt für: