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.Writes synchronously a specified Visual together with a PrintTicket to the target XpsDocument or PrintQueue.

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.Writes synchronously a specified FixedPage together with a PrintTicket to the target XpsDocument or PrintQueue.

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.Writes synchronously a specified FixedDocumentSequence together with a PrintTicket to the target XpsDocument or PrintQueue.

Write(FixedDocument, PrintTicket)

Escribe de forma sincrónica una clase FixedDocument junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.Writes synchronously a FixedDocument together with a PrintTicket to the target XpsDocument or PrintQueue.

Write(String, XpsDocumentNotificationLevel)

Escribe sincrónicamente un documento XPS especificado en el o de destino XpsDocument PrintQueue .Writes synchronously a specified XPS document to the target XpsDocument or PrintQueue.

Write(DocumentPaginator, PrintTicket)

Escribe de forma sincrónica contenido paginado de un DocumentPaginator junto con un PrintTicket en XpsDocument o PrintQueue de destino.Writes synchronously paginated content from a specified DocumentPaginator together with a PrintTicket to the target XpsDocument or PrintQueue.

Write(FixedPage)

Escribe de forma sincrónica un FixedPage especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified FixedPage to the target XpsDocument or PrintQueue.

Write(FixedDocumentSequence)

Escribe de forma sincrónica un FixedDocumentSequence especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified FixedDocumentSequence to the target XpsDocument or PrintQueue.

Write(FixedDocument)

Escribe de forma sincrónica un FixedDocument especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified FixedDocument to the target XpsDocument or PrintQueue.

Write(DocumentPaginator)

Escribe contenido paginado de forma sincrónica de una clase DocumentPaginator especificada en la clase XpsDocument o PrintQueue de destino.Writes synchronously paginated content from a specified DocumentPaginator to the target XpsDocument or PrintQueue.

Write(String)

Escribe asincrónicamente un documento XPS especificado en el elemento XpsDocument o PrintQueue de destino.Synchronously writes a specified XPS document to the target XpsDocument or PrintQueue.

Write(Visual)

Escribe de forma sincrónica un Visual especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified Visual to the target XpsDocument or PrintQueue.

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.Writes synchronously a specified Visual together with a PrintTicket to the target XpsDocument or 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)

Parámetros

visual
Visual

Elemento Visual que se escribe.The Visual that is written.

printTicket
PrintTicket

Clase PrintTicket que representa las preferencias de impresión predeterminadas para el documento.A PrintTicket that represents the default printing preferences for the document.

Comentarios

Para procesar por lotes la escritura a Visual , use VisualsToXpsDocument .To batch write a Visual, use VisualsToXpsDocument.

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue .This method does not validate or modify the specified printTicket for a particular PrintQueue. Si es necesario, utilice el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de PrintQueue y sea válido para una impresora especificada.If necessary, use the MergeAndValidatePrintTicket method to create a PrintTicket that is specific to the PrintQueue and is valid for a specified printer.

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.Writes synchronously a specified FixedPage together with a PrintTicket to the target XpsDocument or 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)

Parámetros

fixedPage
FixedPage

Página que se escribe.The page that is written.

printTicket
PrintTicket

PrintTicket que representa las preferencias de impresión predeterminadas para la página.A PrintTicket that represents the default printing preferences for the page.

Comentarios

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue .This method does not validate or modify the specified printTicket for a particular PrintQueue. Si es necesario, utilice el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de PrintQueue y sea válido para una impresora especificada.If necessary, use the MergeAndValidatePrintTicket method to create a PrintTicket that is specific to the PrintQueue and is valid for a specified printer.

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.Writes synchronously a specified FixedDocumentSequence together with a PrintTicket to the target XpsDocument or 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)

Parámetros

fixedDocumentSequence
FixedDocumentSequence

Conjunto de documentos que se escriben.The set of documents that are written.

printTicket
PrintTicket

Clase PrintTicket que representa las preferencias de impresión predeterminadas para el conjunto de documentos.A PrintTicket that represents the default printing preferences for the set of documents.

Comentarios

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos.Although the XpsDocument class has a singular name, an XpsDocument can be one FixedDocument or a set of multiple documents. Este método agrega un FixedDocument elemento o un conjunto de FixedDocument elementos al conjunto existente.This method adds a FixedDocument or a set of FixedDocument elements to the existing set.

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue .This method does not validate or modify the specified printTicket for a particular PrintQueue. Si es necesario, utilice el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de PrintQueue y sea válido para una impresora especificada.If necessary, use the MergeAndValidatePrintTicket method to create a PrintTicket that is specific to the PrintQueue and is valid for a specified printer.

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.Writes synchronously a FixedDocument together with a PrintTicket to the target XpsDocument or 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)

Parámetros

fixedDocument
FixedDocument

Documento que se escribe.The document that is written.

printTicket
PrintTicket

Clase PrintTicket que representa las preferencias de impresión predeterminadas para el documento.A PrintTicket that represents the default printing preferences for the document.

Comentarios

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos.Although the XpsDocument class has a singular name, an XpsDocument can be one FixedDocument or a set of multiple documents. Este método agrega un FixedDocument al conjunto.This method adds a FixedDocument to the set.

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue .This method does not validate or modify the specified printTicket for a particular PrintQueue. Si es necesario, utilice el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de PrintQueue y sea válido para una impresora especificada.If necessary, use the MergeAndValidatePrintTicket method to create a PrintTicket that is specific to the PrintQueue and is valid for a specified printer.

Se aplica a

Write(String, XpsDocumentNotificationLevel)

Escribe sincrónicamente un documento XPS especificado en el o de destino XpsDocument PrintQueue .Writes synchronously a specified XPS document to the target XpsDocument or 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.The path of the source document.

notificationLevel
XpsDocumentNotificationLevel

Indicación de si la notificación está habilitada.An indication of whether notification is enabled.

Comentarios

Cuando notificationLevel está deshabilitado, el XpsDocumentWriter copia el documento serializedXPS en el destino XpsDocument o PrintQueue que creó el XpsDocumentWriter .When notificationLevel is disabled, the XpsDocumentWriter copies the serializedXPS document to the target XpsDocument or PrintQueue that created the XpsDocumentWriter. Cuando notificationLevel está habilitado, el XpsDocumentWriter primero deserializa el documento, después 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.When notificationLevel is enabled, the XpsDocumentWriter first deserializes the document, next reserializes it, and then writes it to the target with progress notifications as each page is output.

Aunque la XpsDocument clase tiene un nombre singular, XpsDocument puede ser uno FixedDocument o un conjunto de varios documentos.Although the XpsDocument class has a singular name, an XpsDocument can be one FixedDocument or a set of multiple documents. Este método agrega los FixedDocument elementos del origen a la secuencia de FixedDocument elementos en el o de XpsDocument destino PrintQueue .This method adds the FixedDocument elements in the source to the sequence of FixedDocument elements in the target XpsDocument or PrintQueue.

Si notificationLevel se especifica como ReceiveNotificationEnabled , las notificaciones solo se producen cuando el documento se serializa, no se imprime.If notificationLevel is specified as ReceiveNotificationEnabled, notifications are produced only when the document is serialized, not printed. Para recibir notificaciones, se debe reserializar el documento.To receive notifications the document must be reserialized. Cuando se reserializa un documento, se quita todo el contenido de Package que no es necesario conservar en XML Paper Specification (XPS) .When a document is reserialized all content from the Package that is not required to be preserved by the XML Paper Specification (XPS) is removed. La reserialización también quitará todas las extensiones del FixedPage marcado, incluido cualquier contenido XPS extendido.The reserialization will also remove all extensions from the FixedPage markup, including any extended XPS content.

Si notificationLevel se especifica como ReceiveNotificationDisabled el documento no se volverá a serializar y se conservará cualquier contenido extendido, incluso cuando se imprima.If notificationLevel is specified as ReceiveNotificationDisabled the document will not be reserialized and any extended content will be preserved, even when printed.

Por diseño, este Write método no llama al WritingPrintTicketRequired evento.By design this Write method does not call the WritingPrintTicketRequired event.

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.Writes synchronously paginated content from a specified DocumentPaginator together with a PrintTicket to the target XpsDocument or 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)

Parámetros

documentPaginator
DocumentPaginator

Objeto que contiene un puntero a material de origen sin paginar. También contiene métodos para paginar el material.An object that contains a pointer to unpaginated source material and also contains methods for paginating the material.

printTicket
PrintTicket

Un PrintTicket que representa las preferencias de impresión predeterminadas para el material.A PrintTicket that represents the default printing preferences for material.

Comentarios

Este método no valida ni modifica el especificado printTicket para un determinado PrintQueue .This method does not validate or modify the specified printTicket for a particular PrintQueue. Si es necesario, utilice el MergeAndValidatePrintTicket método para crear un PrintTicket que sea específico de PrintQueue y sea válido para una impresora especificada.If necessary, use the MergeAndValidatePrintTicket method to create a PrintTicket that is specific to the PrintQueue and is valid for a specified printer.

Se aplica a

Write(FixedPage)

Escribe de forma sincrónica un FixedPage especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified FixedPage to the target XpsDocument or 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)

Parámetros

fixedPage
FixedPage

Página que se escribe en XpsDocument.A page that is written to the XpsDocument.

Se aplica a

Write(FixedDocumentSequence)

Escribe de forma sincrónica un FixedDocumentSequence especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified FixedDocumentSequence to the target XpsDocument or 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)

Parámetros

fixedDocumentSequence
FixedDocumentSequence

Conjunto de documentos que se escriben en el XpsDocument.A set of documents that is written to the XpsDocument.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el Write método para escribir una secuencia de documentos XPS.The following example shows how to use the Write method to write a sequence of XPS documents.

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.Although the XpsDocument class has a singular name, an XpsDocument can be one FixedDocument or a set of multiple documents. Este método agrega un FixedDocument elemento o un conjunto de FixedDocument elementos al conjunto existente.This method adds a FixedDocument or a set of FixedDocument elements to the existing set.

Se aplica a

Write(FixedDocument)

Escribe de forma sincrónica un FixedDocument especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified FixedDocument to the target XpsDocument or 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)

Parámetros

fixedDocument
FixedDocument

Documento que se escribe en el XpsDocument.A document that is written to the XpsDocument.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar este método para escribir en un documento XPS.The following example shows how to use this method to write to an XPS document.

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.Although the XpsDocument class has a singular name, an XpsDocument can be one FixedDocument or a set of multiple documents. Este método agrega un FixedDocument al conjunto.This method adds a FixedDocument to the set.

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.Writes synchronously paginated content from a specified DocumentPaginator to the target XpsDocument or 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)

Parámetros

documentPaginator
DocumentPaginator

Objeto que contiene un puntero a material de origen sin paginar. También contiene métodos para paginar el material.An object that contains a pointer to unpaginated source material and also contains methods for paginating the material.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el Write método para escribir en un documento XPS.The following example shows how to use the Write method to write to an XPS document.

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.Synchronously writes a specified XPS document to the target XpsDocument or PrintQueue.

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.The path of the source document.

Comentarios

Aunque la XpsDocumentWriter clase tiene un nombre singular, XpsDocumentWriter puede ser uno FixedDocument o un conjunto de varios documentos.Although the XpsDocumentWriter class has a singular name, an XpsDocumentWriter can be one FixedDocument or a set of multiple documents. Este método agrega los FixedDocument elementos del origen al conjunto de elementos de FixedDocument la o de destino XpsDocumentWriter PrintQueue .This method adds the FixedDocument elements in the source to the set of FixedDocument elements in the target XpsDocumentWriter or PrintQueue.

Este Write método volverá a serializar el documento XPS especificado, lo que elimina todo el contenido de Package que no es necesario conservar con la especificación de papel XML.This Write method will reserialize the specified XPS document, which removes all content from the Package that isn't required to be preserved by the XML Paper Specification. La reserialización también quita todas las extensiones del FixedPage marcado, incluido cualquier contenido XPS extendido.The reserialization also removes all extensions from the FixedPage markup, including any extended XPS content.

Por diseño, este Write método no genera el WritingPrintTicketRequired evento.By design, this Write method does not raise the WritingPrintTicketRequired event.

Se aplica a

Write(Visual)

Escribe de forma sincrónica un Visual especificado en XpsDocument o PrintQueue de destino.Writes synchronously a specified Visual to the target XpsDocument or 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)

Parámetros

visual
Visual

Elemento Visual que se escribe.The Visual that is written.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el Write método para escribir un Visual en un documento XPS.The following example shows how to use the Write method to write a Visual to an XPS document.

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 procesar por lotes la escritura a Visual , use VisualsToXpsDocument .To batch write a Visual, use VisualsToXpsDocument.

Se aplica a