Teilen über


XpsDocumentWriter.Write Methode

Definition

Überlädt

Write(Visual, PrintTicket)

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

Write(FixedPage, PrintTicket)

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

Write(FixedDocumentSequence, PrintTicket)

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

Write(FixedDocument, PrintTicket)

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

Write(String, XpsDocumentNotificationLevel)

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

Write(DocumentPaginator, PrintTicket)

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

Write(FixedPage)

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

Write(FixedDocumentSequence)

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

Write(FixedDocument)

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

Write(DocumentPaginator)

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

Write(String)

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

Write(Visual)

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

Write(Visual, PrintTicket)

Schreibt synchron ein angegebenes Visual-Objekt zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die 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 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.

Gilt für:

Write(FixedPage, PrintTicket)

Schreibt synchron ein angegebenes FixedPage-Objekt zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die 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 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.

Gilt für:

Write(FixedDocumentSequence, PrintTicket)

Schreibt synchron ein angegebenes FixedDocumentSequence-Objekt zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die 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

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 einzelnen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Mit dieser Methode wird der vorhandenen Gruppe ein FixedDocument oder ein Satz von FixedDocument Elementen hinzugefügt.

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:

Write(FixedDocument, PrintTicket)

Schreibt synchron ein FixedDocument zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die 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 wird.

printTicket
PrintTicket

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

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:

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 deaktiviert ist, kopiert das XpsDocumentWriter serialisierteXPS-Dokument in das Ziel XpsDocument oder PrintQueue , das erstellt hat XpsDocumentWriter. Wenn notificationLevel aktiviert ist, deserialisiert die XpsDocumentWriter erste das Dokument, das nächste ändert es und schreibt es dann mit Statusbenachrichtigungen in das Ziel, während jede Seite ausgegeben wird.

Obwohl die XpsDocument Klasse einen einzelnen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Mit dieser Methode werden die FixedDocument Elemente in der Quelle der Sequenz von FixedDocument Elementen im Ziel XpsDocument oder PrintQueuehinzugefügt.

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

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

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

Gilt für:

Write(DocumentPaginator, PrintTicket)

Schreibt synchron paginierten Inhalt aus einem angegebenen DocumentPaginator zusammen mit einem PrintTicket in das Ziel-XpsDocument oder in die 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 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 spezifisch für den PrintQueue ist und für einen angegebenen Drucker gültig ist.

Gilt für:

Write(FixedPage)

Schreibt synchron ein angegebenes FixedPage in das Ziel-XpsDocument oder in die 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 XpsDocument geschrieben wird.

Gilt für:

Write(FixedDocumentSequence)

Schreibt synchron ein angegebenes FixedDocumentSequence in das Ziel-XpsDocument oder in die 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

Ein Satz von Dokumenten, der in das XpsDocument geschrieben wird.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Write -Methode verwendet wird, um eine Sequenz 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 einzelnen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Mit dieser Methode wird der vorhandenen Gruppe ein FixedDocument oder ein Satz von FixedDocument Elementen hinzugefügt.

Gilt für:

Write(FixedDocument)

Schreibt synchron ein angegebenes FixedDocument in das Ziel-XpsDocument oder in die 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 XpsDocument 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 einzelnen Namen hat, kann es XpsDocument sich um ein FixedDocument oder mehrere Dokumente handeln. Diese Methode fügt dem Satz einen hinzu FixedDocument .

Gilt für:

Write(DocumentPaginator)

Schreibt synchron paginierten Inhalt aus einem angegebenen DocumentPaginator in das Ziel-XpsDocument oder in die 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 paginiertes Quellmaterial und außerdem Methoden zum Paginieren des Materials enthält.

Beispiele

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

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 die -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 einzelnen Namen hat, kann es XpsDocumentWriter 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 XpsDocumentWriter oder PrintQueuehinzu.

Diese Write Methode ändert die Größe des angegebenen XPS-Dokuments, wodurch alle Inhalte aus dem entfernt werden, 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 ein angegebenes Visual in das Ziel-XpsDocument oder in die 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 geschriebene Visual-Objekt.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Write -Methode verwenden, um ein in Visual 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 VisualsToXpsDocument, um ein Batch zu Visualschreiben.

Gilt für: