XpsDocumentWriter.WriteAsync Método

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

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

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 PrintQueue y que sea válido para una impresora especificada.

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(FixedPage, PrintTicket).

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

Comentarios

Para escribir por lotes , Visualuse VisualsToXpsDocument.

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

Comentarios

Para escribir por lotes , Visualuse 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 PrintQueue y que sea válido para una impresora especificada.

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(Visual, PrintTicket).

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

Comentarios

WriteAsyncescribe un conjunto de documentos de forma asincrónica en XpsDocument o PrintQueue que creó .XpsDocumentWriter Los datos escritos incluyen una PrintTicket información adicional y que el autor de la llamada quiere 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 PrintQueue y que sea válido para una impresora especificada.

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

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 PrintQueue y que sea válido para una impresora especificada.

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

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 PrintQueue y que sea válido para una impresora especificada.

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

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 PrintQueue y que sea válido para una impresora especificada.

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

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 PrintQueue y que sea válido para una impresora especificada.

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(FixedDocumentSequence, PrintTicket).

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

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 PrintQueue y que sea válido para una impresora especificada.

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

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.

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

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 de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(FixedDocumentSequence).

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

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.

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

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 PrintQueue y que sea válido para una impresora especificada.

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(DocumentPaginator, PrintTicket).

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

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

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 arializar 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 generan cuando el documento se serializa, no se imprime. Para recibir notificaciones, el documento debe volver a serrializado. Cuando se vuelve arializar 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á arializar 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 de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(String, XpsDocumentNotificationLevel).

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

Ejemplos

En el ejemplo siguiente se muestra cómo usar este método para escribir en un Visual 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 , Visualuse VisualsToXpsDocument.

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(Visual).

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

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(FixedPage).

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

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 de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(FixedDocument).

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

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 de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(DocumentPaginator).

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

public void WriteAsync(string documentPath);

override this.WriteAsync : string -> unit

Public Sub WriteAsync (documentPath As String)

Parámetros

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 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 WriteAsync método no llama al WritingPrintTicketRequired evento .

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(String).

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

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 PrintQueue y que sea válido para una impresora especificada.

Este método almacena en la tarea que devuelve todas las excepciones de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(FixedDocument, PrintTicket).