XpsDocumentWriter.WriteAsync Método

Definición

Espacio de nombres:

System.Windows.Xps

Ensamblado:

System.Printing.dll

Escribe de forma asincrónica en el XpsDocument o PrintQueue que creó el XpsDocumentWriter.

Sobrecargas

WriteAsync(FixedPage, Object)	Escribe de forma asincrónica un FixedPage especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(FixedPage, PrintTicket)	Escribe de forma asincrónica una clase FixedPage especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.
WriteAsync(Visual, Object)	Escribe de forma asincrónica un Visual especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(Visual, PrintTicket)	Escribe de forma asincrónica una clase Visual especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.
WriteAsync(FixedDocumentSequence, PrintTicket, Object)	Escribe de forma asincrónica una clase FixedDocumentSequence especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.
WriteAsync(FixedDocument, PrintTicket, Object)	Escribe de forma asincrónica una clase FixedDocument especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.
WriteAsync(FixedPage, PrintTicket, Object)	Escribe de forma asincrónica una clase FixedPage especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.
WriteAsync(Visual, PrintTicket, Object)	Escribe de forma asincrónica una clase Visual especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.
WriteAsync(FixedDocumentSequence, PrintTicket)	Escribe de forma asincrónica una clase FixedDocumentSequence especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.
WriteAsync(DocumentPaginator, PrintTicket, Object)	Escribe contenido paginado de forma asincrónica de un DocumentPaginator especificado junto con un PrintTicket en el XpsDocument o PrintQueue de destino.
WriteAsync(FixedDocumentSequence, Object)	Escribe de forma asincrónica un FixedDocumentSequence especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(FixedDocumentSequence)	Escribe de forma asincrónica un FixedDocumentSequence especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(FixedDocument, Object)	Escribe de forma asincrónica un FixedDocument especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(DocumentPaginator, PrintTicket)	Escribe contenido paginado de forma asincrónica de un DocumentPaginator especificado junto con un PrintTicket en el XpsDocument o PrintQueue de destino.
WriteAsync(DocumentPaginator, Object)	Escribe contenido paginado de forma asincrónica de una clase DocumentPaginator especificada en la clase XpsDocument o PrintQueue de destino.
WriteAsync(String, XpsDocumentNotificationLevel)	Escribe de forma asincrónica un documento XPS especificado con la opción de notificación en el destino XpsDocument o PrintQueue.
WriteAsync(Visual)	Escribe de forma asincrónica un Visual especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(FixedPage)	Escribe de forma asincrónica un FixedPage especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(FixedDocument)	Escribe de forma asincrónica un FixedDocument especificado en el XpsDocument o PrintQueue de destino.
WriteAsync(DocumentPaginator)	Escribe contenido paginado de forma asincrónica de una clase DocumentPaginator especificada en la clase XpsDocument o PrintQueue de destino.
WriteAsync(String)	Escribe de forma asincrónica un documento XPS especificado en el destino XpsDocument o PrintQueue.
WriteAsync(FixedDocument, PrintTicket)	Escribe de forma asincrónica una clase FixedDocument especificada junto con una clase PrintTicket en la clase XpsDocument o PrintQueue de destino.

WriteAsync(FixedPage, Object)

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

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)

Parámetros

fixedPage

FixedPage

Página que se escribe.

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

WriteAsync(FixedPage, PrintTicket)

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

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)

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(FixedPage, PrintTicket).

WriteAsync(Visual, Object)

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

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)

Parámetros

visual

Visual

Elemento Visual que se escribe.

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

Comentarios

Para escribir por lotes un Visual, use VisualsToXpsDocument.

WriteAsync(Visual, PrintTicket)

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

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)

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(Visual, PrintTicket).

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

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

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)

Parámetros

fixedDocumentSequence

FixedDocumentSequence

Conjunto de documentos que va a escribir.

printTicket

PrintTicket

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

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

Comentarios

WriteAsyncescribe un conjunto de documentos de forma asincrónica en o XpsDocumentPrintQueue que creó .XpsDocumentWriter Los datos que se escriben incluyen información PrintTicket adicional y que el autor de la llamada desea pasar a un controlador de eventos.

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 a la secuencia 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.

WriteAsync(FixedDocument, PrintTicket, Object)

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

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)

Parámetros

fixedDocument

FixedDocument

Documento que se escribe.

printTicket

PrintTicket

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

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

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 objeto 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.

WriteAsync(FixedPage, PrintTicket, Object)

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

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)

Parámetros

fixedPage

FixedPage

Página que se escribe.

printTicket

PrintTicket

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

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

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.

WriteAsync(Visual, PrintTicket, Object)

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

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)

Parámetros

visual

Visual

Elemento Visual que se escribe.

printTicket

PrintTicket

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

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

Comentarios

Para escribir varios Visual elementos, 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.

WriteAsync(FixedDocumentSequence, PrintTicket)

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

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)

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(FixedDocumentSequence, PrintTicket).

WriteAsync(DocumentPaginator, PrintTicket, Object)

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

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)

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

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

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

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.

WriteAsync(FixedDocumentSequence, Object)

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

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)

Parámetros

fixedDocumentSequence

FixedDocumentSequence

Conjunto de documentos que se escriben.

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

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.

WriteAsync(FixedDocumentSequence)

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

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)

Parámetros

fixedDocumentSequence

FixedDocumentSequence

Conjunto de documentos que se escriben.

Ejemplos

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

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

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 almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(FixedDocumentSequence).

WriteAsync(FixedDocument, Object)

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

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)

Parámetros

fixedDocument

FixedDocument

Documento que se escribe.

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

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 objeto al conjunto.

WriteAsync(DocumentPaginator, PrintTicket)

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

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)

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

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(DocumentPaginator, PrintTicket).

WriteAsync(DocumentPaginator, Object)

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

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)

Parámetros

documentPaginator

DocumentPaginator

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

userSuppliedState

Object

Objeto especificado por el usuario que se va a identificar y asociar con la operación asincrónica.

WriteAsync(String, XpsDocumentNotificationLevel)

Escribe de forma asincrónica un documento XPS especificado con la opción de notificación en el destino XpsDocument o 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)

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 XPS serializado 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 con la especificación de papel XML . La reserialización también quita 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 WriteAsync método no llama al WritingPrintTicketRequired evento .

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(String, XpsDocumentNotificationLevel).

WriteAsync(Visual)

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

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)

Parámetros

visual

Visual

Elemento Visual que se escribe.

Ejemplos

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

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

Comentarios

Para escribir por lotes un Visual, use VisualsToXpsDocument.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(Visual).

WriteAsync(FixedPage)

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

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)

Parámetros

fixedPage

FixedPage

Página que se escribe.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(FixedPage).

WriteAsync(FixedDocument)

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

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)

Parámetros

fixedDocument

FixedDocument

Documento que se escribe.

Ejemplos

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

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

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 objeto al conjunto.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(FixedDocument).

WriteAsync(DocumentPaginator)

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

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)

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 este método para escribir en un documento XPS.

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

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(DocumentPaginator).

WriteAsync(String)

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

public:
 void WriteAsync(System::String ^ documentPath);

public void WriteAsync (string documentPath);

override this.WriteAsync : string -> unit

Public Sub WriteAsync (documentPath As String)

Parámetros

documentPath

String

Ruta de acceso del documento de origen.

Comentarios

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 al conjunto de FixedDocument elementos del destino XpsDocument o PrintQueue.

Este WriteAsync método vuelve a serializar el documento XPS especificado, que quita todo el contenido de la Package clase que no es necesaria para conservarla en 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 WriteAsync método no llama al WritingPrintTicketRequired evento .

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Write(String).

WriteAsync(FixedDocument, PrintTicket)

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

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)

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Write(FixedDocument, PrintTicket).