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

Observações

Este 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 que seja específico para o PrintQueue e válido para uma impressora especificada.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

Para escrever 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

Observações

Para escrever em lote um Visual, use VisualsToXpsDocument.

Este 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 que seja específico para o PrintQueue e válido para uma impressora especificada.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

WriteAsync escreve um conjunto de documentos de forma assíncrona no XpsDocument ou PrintQueue que criou o XpsDocumentWriter. Os dados escritos incluem uma PrintTicket informação adicional que o chamador quer transmitir a um gestor de eventos.

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

Este 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 que seja 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

Observações

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

Este 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 que seja 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

Observações

Este 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 que seja 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

Observações

Para escrever múltiplos Visual elementos, use VisualsToXpsDocument.

Este 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 que seja 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

Observações

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

Este 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 que seja específico para o PrintQueue e válido para uma impressora especificada.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

Este 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 que seja 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

Observações

Embora a XpsDocument classe tenha um nome singular, an XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Este 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 seguinte mostra como usar este método para escrever num 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

Observações

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

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

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

Observações

Este 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 que seja específico para o PrintQueue e válido para uma impressora especificada.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

Quando notificationLevel está desativado, copia XpsDocumentWriter o documento XPS serializado para o destino XpsDocument ou PrintQueue para o que criou o XpsDocumentWriter. Quando notificationLevel está ativado, o XpsDocumentWriter primeiro desserializa o documento, depois reserializa-o e depois escreve-o no destino com notificações de progresso à medida que cada página é produzida.

Embora a XpsDocument classe tenha um nome singular, an XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Este método adiciona os FixedDocument elementos da fonte à sequência de FixedDocument elementos no alvo XpsDocument ou PrintQueue.

Se notificationLevel for especificado como ReceiveNotificationEnabled, as notificações são produzidas apenas quando o documento é serializado, não impresso. Para receber notificações, o documento deve ser reserializado. Quando um documento é reserializado, todo o conteúdo do Package que não é obrigado a ser preservado pela Especificação XML Paper é 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 alargado será preservado, mesmo quando impresso.

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

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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 seguinte mostra como usar este método para escrever um Visual num 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

Observações

Para escrever em lote um Visual, use VisualsToXpsDocument.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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 seguinte mostra como usar este método para escrever num 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

Observações

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

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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 seguinte mostra como usar este método para escrever num 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

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

Embora a XpsDocument classe tenha um nome singular, an XpsDocument pode ser um FixedDocument ou um conjunto de vários documentos. Este método adiciona os FixedDocument elementos da fonte ao conjunto de FixedDocument elementos no alvo XpsDocument ou PrintQueue.

Este WriteAsync método reserializa o documento XPS especificado, removendo todo o conteúdo Package que não é obrigado a ser preservado pela Especificação XML Paper. A reserialização também remove todas as extensões da FixedPage marcação, incluindo qualquer conteúdo XPS estendido.

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

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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

Observações

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

Este 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 que seja específico para o PrintQueue e válido para uma impressora especificada.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(FixedDocument, PrintTicket).