XpsDocumentWriter.WriteAsync Método

Definição

Namespace:

System.Windows.Xps

Assembly:

System.Printing.dll

Grava de forma assíncrona no XpsDocument ou PrintQueue que criou o XpsDocumentWriter.

Sobrecargas

WriteAsync(FixedPage, Object)	Grava de forma assíncrona um FixedPage especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedPage, PrintTicket)	Grava de forma assíncrona um especificado FixedPage junto com um PrintTicket no XpsDocument ou PrintQueue de destino.
WriteAsync(Visual, Object)	Grava de forma assíncrona um Visual especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(Visual, PrintTicket)	Grava de forma assíncrona um especificado Visual junto com um PrintTicket no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedDocumentSequence, PrintTicket, Object)	Grava de forma assíncrona um especificado FixedDocumentSequence junto com um PrintTicket no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedDocument, PrintTicket, Object)	Grava de forma assíncrona um especificado FixedDocument junto com um PrintTicket no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedPage, PrintTicket, Object)	Grava de forma assíncrona um especificado FixedPage junto com um PrintTicket no XpsDocument ou PrintQueue de destino.
WriteAsync(Visual, PrintTicket, Object)	Grava de forma assíncrona um especificado Visual junto com um PrintTicket no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedDocumentSequence, PrintTicket)	Grava de forma assíncrona um especificado FixedDocumentSequence junto com um PrintTicket no XpsDocument ou PrintQueue de destino.
WriteAsync(DocumentPaginator, PrintTicket, Object)	Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator junto com um PrintTicket especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedDocumentSequence, Object)	Grava de forma assíncrona um FixedDocumentSequence especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedDocumentSequence)	Grava de forma assíncrona um FixedDocumentSequence especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedDocument, Object)	Grava de forma assíncrona um FixedDocument especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(DocumentPaginator, PrintTicket)	Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator junto com um PrintTicket especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(DocumentPaginator, Object)	Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator para o XpsDocument ou PrintQueue de destino.
WriteAsync(String, XpsDocumentNotificationLevel)	Grava de forma assíncrona um documento XPS especificado com a opção de notificação para o destino XpsDocument ou PrintQueue.
WriteAsync(Visual)	Grava de forma assíncrona um Visual especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedPage)	Grava de forma assíncrona um FixedPage especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(FixedDocument)	Grava de forma assíncrona um FixedDocument especificado no XpsDocument ou PrintQueue de destino.
WriteAsync(DocumentPaginator)	Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator para o XpsDocument ou PrintQueue de destino.
WriteAsync(String)	Grava de forma assíncrona um documento XPS especificado no destino XpsDocument ou PrintQueue.
WriteAsync(FixedDocument, PrintTicket)	Grava de forma assíncrona um especificado FixedDocument junto com um PrintTicket no XpsDocument ou PrintQueue de destino.

WriteAsync(FixedPage, Object)

Grava de forma assíncrona um FixedPage especificado no XpsDocument ou 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

A página que é gravada.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

WriteAsync(FixedPage, PrintTicket)

Grava de forma assíncrona um especificado FixedPage junto com um PrintTicket no XpsDocument ou 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

A página que é gravada.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para a página.

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

WriteAsync(Visual, Object)

Grava de forma assíncrona um Visual especificado no XpsDocument ou 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

O Visual que é gravado.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

Comentários

Para gravar em lote um Visual, use VisualsToXpsDocument.

WriteAsync(Visual, PrintTicket)

Grava de forma assíncrona um especificado Visual junto com um PrintTicket no XpsDocument ou 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

O Visual que é gravado.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o documento.

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

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Grava de forma assíncrona um especificado FixedDocumentSequence junto com um PrintTicket no XpsDocument ou 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

O conjunto de documentos a ser gravado.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o conjunto de documentos.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

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.

WriteAsync(FixedDocument, PrintTicket, Object)

Grava de forma assíncrona um especificado FixedDocument junto com um PrintTicket no XpsDocument ou 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

O documento que é gravado.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o documento.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

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.

WriteAsync(FixedPage, PrintTicket, Object)

Grava de forma assíncrona um especificado FixedPage junto com um PrintTicket no XpsDocument ou 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

A página que é gravada.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para a página.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

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.

WriteAsync(Visual, PrintTicket, Object)

Grava de forma assíncrona um especificado Visual junto com um PrintTicket no XpsDocument ou 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

O Visual que é gravado.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o documento.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

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.

WriteAsync(FixedDocumentSequence, PrintTicket)

Grava de forma assíncrona um especificado FixedDocumentSequence junto com um PrintTicket no XpsDocument ou 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

O conjunto de documentos que são gravados.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o conjunto de documentos.

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

WriteAsync(DocumentPaginator, PrintTicket, Object)

Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator junto com um PrintTicket especificado no XpsDocument ou 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

Um objeto que contém um ponteiro para um material de origem não paginado; também contém métodos para a paginação do material.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o material.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

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.

WriteAsync(FixedDocumentSequence, Object)

Grava de forma assíncrona um FixedDocumentSequence especificado no XpsDocument ou 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

O conjunto de documentos que são gravados.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

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.

WriteAsync(FixedDocumentSequence)

Grava de forma assíncrona um FixedDocumentSequence especificado no XpsDocument ou 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

O conjunto de documentos que é gravado.

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

WriteAsync(FixedDocument, Object)

Grava de forma assíncrona um FixedDocument especificado no XpsDocument ou 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

O documento que é gravado.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

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.

WriteAsync(DocumentPaginator, PrintTicket)

Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator junto com um PrintTicket especificado no XpsDocument ou 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

Um objeto que contém um ponteiro para um material de origem não paginado e que também contém métodos para a paginação do material.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o material.

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

WriteAsync(DocumentPaginator, Object)

Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator para o XpsDocument ou 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

Um objeto que contém um ponteiro para um material de origem não paginado; também contém métodos para a paginação do material.

userSuppliedState

Object

Um objeto especificado pelo usuário para identificar a operação assíncrona e ser associado a ela.

WriteAsync(String, XpsDocumentNotificationLevel)

Grava de forma assíncrona um documento XPS especificado com a opção de notificação para o destino XpsDocument ou 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

O caminho do documento de origem.

notificationLevel

XpsDocumentNotificationLevel

Uma indicação se a notificação está habilitada.

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

WriteAsync(Visual)

Grava de forma assíncrona um Visual especificado no XpsDocument ou 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

O Visual que é gravado.

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

WriteAsync(FixedPage)

Grava de forma assíncrona um FixedPage especificado no XpsDocument ou 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

A página que é gravada.

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

WriteAsync(FixedDocument)

Grava de forma assíncrona um FixedDocument especificado no XpsDocument ou 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

O documento que é gravado.

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

WriteAsync(DocumentPaginator)

Grava de forma assíncrona o conteúdo paginado de um DocumentPaginator para o XpsDocument ou 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

Um objeto que contém um ponteiro para um material de origem não paginado e que também contém métodos para a paginação do material.

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

WriteAsync(String)

Grava de forma assíncrona um documento XPS especificado no destino XpsDocument ou 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

O caminho do documento de origem.

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

WriteAsync(FixedDocument, PrintTicket)

Grava de forma assíncrona um especificado FixedDocument junto com um PrintTicket no XpsDocument ou 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

O documento que é gravado.

printTicket

PrintTicket

Um PrintTicket que representa as preferências de impressão padrão para o documento.

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