XpsDocumentWriter.Write Método

Definición

Sobrecargas

Write(Visual, PrintTicket)

Escribe de forma sincrónica una clase Visual especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

Write(FixedPage, PrintTicket)

Escribe de forma sincrónica una clase FixedPage especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

Write(FixedDocumentSequence, PrintTicket)

Escribe de forma sincrónica una clase FixedDocumentSequence especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

Write(FixedDocument, PrintTicket)

Escribe de forma sincrónica una clase FixedDocument junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

Write(String, XpsDocumentNotificationLevel)

Escribe de forma sincrónica un documento XPS especificado en el destino XpsDocument o PrintQueue.

Write(DocumentPaginator, PrintTicket)

Escribe de forma sincrónica contenido paginado de un DocumentPaginator junto con un PrintTicket en XpsDocument o PrintQueue de destino.

Write(FixedPage)

Escribe de forma sincrónica un FixedPage especificado en XpsDocument o PrintQueue de destino.

Write(FixedDocumentSequence)

Escribe de forma sincrónica un FixedDocumentSequence especificado en XpsDocument o PrintQueue de destino.

Write(FixedDocument)

Escribe de forma sincrónica un FixedDocument especificado en XpsDocument o PrintQueue de destino.

Write(DocumentPaginator)

Escribe contenido paginado de forma sincrónica de una clase DocumentPaginator especificada en la clase XpsDocument o PrintQueue de destino.

Write(String)

Escribe asincrónicamente un documento XPS especificado en el elemento XpsDocument o PrintQueue de destino.

Write(Visual)

Escribe de forma sincrónica un Visual especificado en XpsDocument o PrintQueue de destino.

Write(Visual, PrintTicket)

Escribe de forma sincrónica una clase Visual especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

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)

Parámetros

visual
Visual

Elemento Visual que se escribe.

printTicket
PrintTicket

Clase PrintTicket que representa las preferencias de impresión predeterminadas para el documento.

Comentarios

Para escribir por lotes un Visual, use VisualsToXpsDocument.

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue. Si es necesario, use el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de y PrintQueue sea válido para una impresora especificada.

Se aplica a

Write(FixedPage, PrintTicket)

Escribe de forma sincrónica una clase FixedPage especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

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)

Parámetros

fixedPage
FixedPage

Página que se escribe.

printTicket
PrintTicket

PrintTicket que representa las preferencias de impresión predeterminadas para la página.

Comentarios

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue. Si es necesario, use el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de y PrintQueue sea válido para una impresora especificada.

Se aplica a

Write(FixedDocumentSequence, PrintTicket)

Escribe de forma sincrónica una clase FixedDocumentSequence especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

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)

Parámetros

fixedDocumentSequence
FixedDocumentSequence

Conjunto de documentos que se escriben.

printTicket
PrintTicket

Clase PrintTicket que representa las preferencias de impresión predeterminadas para el conjunto de documentos.

Comentarios

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos. Este método agrega un FixedDocument o un conjunto de FixedDocument elementos al conjunto existente.

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue. Si es necesario, use el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de y PrintQueue sea válido para una impresora especificada.

Se aplica a

Write(FixedDocument, PrintTicket)

Escribe de forma sincrónica una clase FixedDocument junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

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)

Parámetros

fixedDocument
FixedDocument

Documento que se escribe.

printTicket
PrintTicket

Clase PrintTicket que representa las preferencias de impresión predeterminadas para el documento.

Comentarios

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos. Este método agrega un FixedDocument al conjunto.

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue. Si es necesario, use el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de y PrintQueue sea válido para una impresora especificada.

Se aplica a

Write(String, XpsDocumentNotificationLevel)

Escribe de forma sincrónica un documento XPS especificado en el destino XpsDocument o 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)

Parámetros

documentPath
String

Ruta de acceso del documento de origen.

notificationLevel
XpsDocumentNotificationLevel

Indicación de si la notificación está habilitada.

Comentarios

Cuando notificationLevel está deshabilitado, XpsDocumentWriter copia el documento serializadoXPS en el destino XpsDocument o PrintQueue que creó .XpsDocumentWriter Cuando notificationLevel está habilitado, el XpsDocumentWriter primero deserializa el documento, lo vuelve a serializar y, a continuación, lo escribe en el destino con notificaciones de progreso a medida que se genera cada página.

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos. Este método agrega los FixedDocument elementos del origen a la secuencia de FixedDocument elementos del destino XpsDocument o PrintQueue.

Si notificationLevel se especifica como ReceiveNotificationEnabled, las notificaciones solo se producen cuando el documento se serializa, no se imprime. Para recibir notificaciones, se debe volver a serializar el documento. Cuando se vuelve a serializar un documento, se quita todo el contenido de que Package no es necesario conservar mediante la especificación de papel XML (XPS). La reserialización también quitará todas las extensiones del FixedPage marcado, incluido cualquier contenido XPS extendido.

Si notificationLevel se especifica como ReceiveNotificationDisabled el documento no se volverá a serializar y se conservará cualquier contenido extendido, incluso cuando se imprima.

Por diseño, este Write método no llama al WritingPrintTicketRequired evento .

Se aplica a

Write(DocumentPaginator, PrintTicket)

Escribe de forma sincrónica contenido paginado de un DocumentPaginator junto con un PrintTicket en XpsDocument o PrintQueue de destino.

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)

Parámetros

documentPaginator
DocumentPaginator

Objeto que contiene un puntero a material de origen sin paginar. También contiene métodos para paginar el material.

printTicket
PrintTicket

Un PrintTicket que representa las preferencias de impresión predeterminadas para el material.

Comentarios

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue. Si es necesario, use el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de y PrintQueue sea válido para una impresora especificada.

Se aplica a

Write(FixedPage)

Escribe de forma sincrónica un FixedPage especificado en XpsDocument o PrintQueue de destino.

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)

Parámetros

fixedPage
FixedPage

Página que se escribe en XpsDocument.

Se aplica a

Write(FixedDocumentSequence)

Escribe de forma sincrónica un FixedDocumentSequence especificado en XpsDocument o PrintQueue de destino.

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)

Parámetros

fixedDocumentSequence
FixedDocumentSequence

Conjunto de documentos que se escriben en el XpsDocument.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el Write método para escribir una secuencia de documentos XPS.

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

Comentarios

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos. Este método agrega un FixedDocument o un conjunto de FixedDocument elementos al conjunto existente.

Se aplica a

Write(FixedDocument)

Escribe de forma sincrónica un FixedDocument especificado en XpsDocument o PrintQueue de destino.

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)

Parámetros

fixedDocument
FixedDocument

Documento que se escribe en el XpsDocument.

Ejemplos

En el ejemplo siguiente se muestra cómo usar este método para escribir en un documento XPS.

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

Comentarios

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos. Este método agrega un FixedDocument al conjunto.

Se aplica a

Write(DocumentPaginator)

Escribe contenido paginado de forma sincrónica de una clase DocumentPaginator especificada en la clase XpsDocument o PrintQueue de destino.

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)

Parámetros

documentPaginator
DocumentPaginator

Objeto que contiene un puntero a material de origen sin paginar. También contiene métodos para paginar el material.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el Write método para escribir en un documento XPS.

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

Se aplica a

Write(String)

Escribe asincrónicamente un documento XPS especificado en el elemento XpsDocument o PrintQueue de destino.

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

Parámetros

documentPath
String

Ruta de acceso del documento de origen.

Comentarios

Aunque la XpsDocumentWriter clase tiene un nombre singular, XpsDocumentWriter puede ser uno FixedDocument o un conjunto de varios documentos. Este método agrega los FixedDocument elementos del origen al conjunto de FixedDocument elementos del destino XpsDocumentWriter o PrintQueue.

Este Write método vuelve a serializar el documento XPS especificado, que quita todo el Package contenido del objeto que no es necesario conservar con la especificación de papel XML. La reserialización también quita todas las extensiones del FixedPage marcado, incluido cualquier contenido XPS extendido.

Por diseño, este Write método no genera el WritingPrintTicketRequired evento .

Se aplica a

Write(Visual)

Escribe de forma sincrónica un Visual especificado en XpsDocument o PrintQueue de destino.

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)

Parámetros

visual
Visual

Elemento Visual que se escribe.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el Write método para escribir en Visual un documento XPS.

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

Comentarios

Para escribir por lotes un Visual, use VisualsToXpsDocument.

Se aplica a