XpsDocumentWriter.Write Método

public:
 override void Write(System::Windows::Media::Visual ^ visual, System::Printing::PrintTicket ^ printTicket);

public override void Write (System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Media.Visual * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (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.

public:
 override void Write(System::Windows::Documents::FixedPage ^ fixedPage, System::Printing::PrintTicket ^ printTicket);

public override void Write (System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.FixedPage * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (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.

public:
 override void Write(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Printing::PrintTicket ^ printTicket);

public override void Write (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.FixedDocumentSequence * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (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.

public:
 override void Write(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Printing::PrintTicket ^ printTicket);

public override void Write (System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.FixedDocument * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (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.

public:
 void Write(System::String ^ documentPath, System::Windows::Xps::XpsDocumentNotificationLevel notificationLevel);

public void Write (string documentPath, System.Windows.Xps.XpsDocumentNotificationLevel notificationLevel);

override this.Write : string * System.Windows.Xps.XpsDocumentNotificationLevel -> unit

Public Sub Write (documentPath As String, notificationLevel As XpsDocumentNotificationLevel)

Parâmetros

Comentários

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

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 precisa ser preservado pela XPS (Especificação de Papel XML) é removido. A reserialização também removerá 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 Write método não chama o WritingPrintTicketRequired evento .

public:
 override void Write(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Printing::PrintTicket ^ printTicket);

public override void Write (System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.DocumentPaginator * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (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.

public:
 override void Write(System::Windows::Documents::FixedPage ^ fixedPage);

public override void Write (System.Windows.Documents.FixedPage fixedPage);

override this.Write : System.Windows.Documents.FixedPage -> unit

Public Overrides Sub Write (fixedPage As FixedPage)

Parâmetros

public:
 override void Write(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence);

public override void Write (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence);

override this.Write : System.Windows.Documents.FixedDocumentSequence -> unit

Public Overrides Sub Write (fixedDocumentSequence As FixedDocumentSequence)

Parâmetros

Exemplos

O exemplo a seguir mostra como usar o Write método para gravar uma sequência de documentos XPS.

private void SaveMultipleFixedContentDocuments(
             XpsDocumentWriter xpsdw, FixedDocumentSequence fds)
{
    // Write the FixedDocumentSequence as a collection of documents
    xpsdw.Write(fds);
}

Private Sub SaveMultipleFixedContentDocuments(ByVal xpsdw As XpsDocumentWriter, ByVal fds As FixedDocumentSequence)
    ' Write the FixedDocumentSequence as a collection of documents
    xpsdw.Write(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.

public:
 override void Write(System::Windows::Documents::FixedDocument ^ fixedDocument);

public override void Write (System.Windows.Documents.FixedDocument fixedDocument);

override this.Write : System.Windows.Documents.FixedDocument -> unit

Public Overrides Sub Write (fixedDocument As FixedDocument)

Parâmetros

Exemplos

O exemplo a seguir mostra como usar esse método para gravar em um documento XPS.

private void SaveSingleFixedContentDocument(
             XpsDocumentWriter xpsdw, FixedDocument fd)
{
    xpsdw.Write(fd);        // Write the FixedDocument as a document.
}

Private Sub SaveSingleFixedContentDocument(ByVal xpsdw As XpsDocumentWriter, ByVal fd As FixedDocument)
    xpsdw.Write(fd) ' Write the FixedDocument as a document.
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.

public:
 override void Write(System::Windows::Documents::DocumentPaginator ^ documentPaginator);

public override void Write (System.Windows.Documents.DocumentPaginator documentPaginator);

override this.Write : System.Windows.Documents.DocumentPaginator -> unit

Public Overrides Sub Write (documentPaginator As DocumentPaginator)

Parâmetros

Exemplos

O exemplo a seguir mostra como usar o Write método para gravar em um documento XPS.

private void SaveSingleFlowContentDocument(
             XpsDocumentWriter xpsdw, DocumentPaginator docPaginator)
{
    xpsdw.Write(docPaginator); // Write the DocPaginator as a document.
}

Private Sub SaveSingleFlowContentDocument(ByVal xpsdw As XpsDocumentWriter, ByVal docPaginator As DocumentPaginator)
    xpsdw.Write(docPaginator) ' Write the DocPaginator as a document.
End Sub

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

public void Write (string documentPath);

override this.Write : string -> unit

Public Sub Write (documentPath As String)

Parâmetros

Comentários

Embora a XpsDocumentWriter classe tenha um nome singular, um XpsDocumentWriter 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 XpsDocumentWriter ou PrintQueue.

Esse Write método reserializa o documento XPS especificado, que remove todo o Package conteúdo do que não precisa 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 Write método não aciona o WritingPrintTicketRequired evento.

public:
 override void Write(System::Windows::Media::Visual ^ visual);

public override void Write (System.Windows.Media.Visual visual);

override this.Write : System.Windows.Media.Visual -> unit

Public Overrides Sub Write (visual As Visual)

Parâmetros

Exemplos

O exemplo a seguir mostra como usar o Write método para gravar um em um Visual documento XPS.

private void SaveVisual(XpsDocumentWriter xpsdw, Visual v)
{
    xpsdw.Write(v); // Write visual to single page
}

Private Sub SaveVisual(ByVal xpsdw As XpsDocumentWriter, ByVal v As Visual)
    xpsdw.Write(v) ' Write visual to single page
End Sub

Comentários

Para gravar em lote um Visual, use VisualsToXpsDocument.