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

Comentários

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora especificada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

Para gravar em lote um Visual, use 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

Comentários

Para gravar em lote um Visual, use VisualsToXpsDocument.

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora especificada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

WriteAsync grava um conjunto de documentos de forma assíncrona no XpsDocument ou PrintQueue que criou o XpsDocumentWriter. Os dados gravados incluem uma PrintTicket e informações adicionais que o chamador deseja passar para um manipulador de eventos.

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ou um conjunto de FixedDocument elementos à sequência existente.

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ao conjunto.

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora 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

Comentários

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora 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

Comentários

Para escrever vários Visual elementos, use VisualsToXpsDocument.

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ou um conjunto de FixedDocument elementos ao conjunto existente.

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora especificada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ou um conjunto de FixedDocument elementos ao 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

Exemplos

O exemplo a seguir mostra como usar esse método para gravar em um 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ou um conjunto de FixedDocument elementos ao conjunto existente.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ao 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

Comentários

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora especificada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

Quando notificationLevel é desabilitado, o XpsDocumentWriter copia o documento XPS serializado para o destino XpsDocument ou PrintQueue que criou o XpsDocumentWriter. Quando notificationLevel está habilitado, o XpsDocumentWriter primeiro desserializa o documento, o próximo o reserializa e, em seguida, grava-o no destino com notificações de progresso à medida que cada página é saída.

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona os FixedDocument elementos na origem à sequência de FixedDocument elementos no destino XpsDocument ou PrintQueue.

Se notificationLevel for especificado como ReceiveNotificationEnabled, as notificações serão produzidas somente quando o documento for serializado, não impresso. Para receber notificações, o documento deve ser reserializado. Quando um documento é reserializado, todo o Package conteúdo do que não é necessário para ser preservado pela Especificação de Papel XML é removido. A reserialização também remove todas as extensões da FixedPage marcação, incluindo qualquer conteúdo XPS estendido.

Se notificationLevel for especificado como ReceiveNotificationDisabled o documento não será reserializado e qualquer conteúdo estendido será preservado, mesmo quando impresso.

Por design, esse WriteAsync método não chama o WritingPrintTicketRequired evento.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Exemplos

O exemplo a seguir mostra como usar esse método para gravar um em Visual um 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

Comentários

Para gravar em lote um Visual, use VisualsToXpsDocument.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Exemplos

O exemplo a seguir mostra como usar esse método para gravar em um 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ao conjunto.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Exemplos

O exemplo a seguir mostra como usar esse método para gravar em um 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

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona os FixedDocument elementos na origem ao conjunto de FixedDocument elementos no destino XpsDocument ou PrintQueue.

Esse WriteAsync método reserializa o documento XPS especificado, que remove todo o Package conteúdo do que não é necessário para ser preservado pela Especificação de Papel XML. A reserialização também remove todas as extensões da FixedPage marcação, incluindo qualquer conteúdo XPS estendido.

Por design, esse WriteAsync método não chama o WritingPrintTicketRequired evento.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas 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

Comentários

Embora a XpsDocument classe tenha um nome singular, um XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Esse método adiciona um FixedDocument ao conjunto.

Esse método não valida nem modifica o especificado printTicket para um determinado PrintQueue. Se necessário, use o MergeAndValidatePrintTicket método para criar um PrintTicket específico para o PrintQueue e é válido para uma impressora especificada.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Write(FixedDocument, PrintTicket).