XpsDocumentWriter.Write Método

Definição

Sobrecargas

Nome Description
Write(Visual, PrintTicket)

Grava de forma síncrona um especificado Visual junto com um PrintTicket no destino XpsDocument ou PrintQueue.

Write(FixedPage, PrintTicket)

Grava de forma síncrona um especificado FixedPage junto com um PrintTicket no destino XpsDocument ou PrintQueue.

Write(FixedDocumentSequence, PrintTicket)

Grava de forma síncrona um especificado FixedDocumentSequence junto com um PrintTicket no destino XpsDocument ou PrintQueue.

Write(FixedDocument, PrintTicket)

Grava de forma síncrona um FixedDocument conjunto com um PrintTicket no destino XpsDocument ou PrintQueue.

Write(String, XpsDocumentNotificationLevel)

Grava de forma síncrona um documento XPS especificado no destino XpsDocument ou PrintQueue.

Write(DocumentPaginator, PrintTicket)

Grava conteúdo paginado de forma síncrona de um especificado DocumentPaginator junto com um PrintTicket para o destino XpsDocument ou PrintQueue.

Write(FixedPage)

Grava de forma síncrona uma especificada FixedPage para o destino XpsDocument ou PrintQueue.

Write(FixedDocumentSequence)

Grava de forma síncrona uma especificada FixedDocumentSequence para o destino XpsDocument ou PrintQueue.

Write(FixedDocument)

Grava de forma síncrona uma especificada FixedDocument para o destino XpsDocument ou PrintQueue.

Write(DocumentPaginator)

Grava conteúdo paginado de forma síncrona de um especificado DocumentPaginator para o destino XpsDocument ou PrintQueue.

Write(String)

Grava de forma síncrona um documento XPS especificado no destino XpsDocument ou PrintQueue.

Write(Visual)

Grava de forma síncrona uma especificada Visual para o destino XpsDocument ou PrintQueue.

Write(Visual, PrintTicket)

Grava de forma síncrona um especificado Visual junto com um PrintTicket no destino XpsDocument ou PrintQueue.

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

visual
Visual

O Visual que está escrito.

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

Aplica-se a

Write(FixedPage, PrintTicket)

Grava de forma síncrona um especificado FixedPage junto com um PrintTicket no destino XpsDocument ou PrintQueue.

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

fixedPage
FixedPage

A página que está escrita.

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

Aplica-se a

Write(FixedDocumentSequence, PrintTicket)

Grava de forma síncrona um especificado FixedDocumentSequence junto com um PrintTicket no destino XpsDocument ou PrintQueue.

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

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, pode XpsDocument 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 que seja específico ao PrintQueue e seja válido para uma impressora especificada.

Aplica-se a

Write(FixedDocument, PrintTicket)

Grava de forma síncrona um FixedDocument conjunto com um PrintTicket no destino XpsDocument ou PrintQueue.

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

fixedDocument
FixedDocument

O documento que está escrito.

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, pode XpsDocument 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 que seja específico ao PrintQueue e seja válido para uma impressora especificada.

Aplica-se a

Write(String, XpsDocumentNotificationLevel)

Grava de forma síncrona um documento XPS especificado no destino XpsDocument ou PrintQueue.

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

documentPath
String

O caminho do documento de origem.

notificationLevel
XpsDocumentNotificationLevel

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

Comentários

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

Embora a XpsDocument classe tenha um nome singular, pode XpsDocument 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 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.

Ao projetar, esse Write método não chama o WritingPrintTicketRequired evento.

Aplica-se a

Write(DocumentPaginator, PrintTicket)

Grava conteúdo paginado de forma síncrona de um especificado DocumentPaginator junto com um PrintTicket para o destino XpsDocument ou PrintQueue.

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

documentPaginator
DocumentPaginator

Um objeto que contém um ponteiro para material de origem nãopaginado e também contém métodos para paginar o material.

printTicket
PrintTicket

Um PrintTicket que representa as preferências de impressão padrão do 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 que seja específico ao PrintQueue e seja válido para uma impressora especificada.

Aplica-se a

Write(FixedPage)

Grava de forma síncrona uma especificada FixedPage para o destino XpsDocument ou PrintQueue.

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

fixedPage
FixedPage

Uma página que é escrita no XpsDocument.

Aplica-se a

Write(FixedDocumentSequence)

Grava de forma síncrona uma especificada FixedDocumentSequence para o destino XpsDocument ou PrintQueue.

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

fixedDocumentSequence
FixedDocumentSequence

Um conjunto de documentos que é gravado no XpsDocument.

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, pode XpsDocument 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.

Aplica-se a

Write(FixedDocument)

Grava de forma síncrona uma especificada FixedDocument para o destino XpsDocument ou PrintQueue.

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

fixedDocument
FixedDocument

Um documento que é gravado no XpsDocument.

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

Aplica-se a

Write(DocumentPaginator)

Grava conteúdo paginado de forma síncrona de um especificado DocumentPaginator para o destino XpsDocument ou PrintQueue.

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

documentPaginator
DocumentPaginator

Um objeto que contém um ponteiro para material de origem nãopaginado e também contém métodos para paginar o material.

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

Aplica-se a

Write(String)

Grava de forma síncrona um documento XPS especificado no destino XpsDocument ou PrintQueue.

public:
 void Write(System::String ^ documentPath);
public void Write(string documentPath);
override this.Write : string -> unit
Public Sub Write (documentPath As String)

Parâmetros

documentPath
String

O caminho do documento de origem.

Comentários

Embora a XpsDocumentWriter classe tenha um nome singular, pode XpsDocumentWriter 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 é 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 Write método não gera o WritingPrintTicketRequired evento.

Aplica-se a

Write(Visual)

Grava de forma síncrona uma especificada Visual para o destino XpsDocument ou PrintQueue.

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

visual
Visual

O Visual que está escrito.

Exemplos

O exemplo a seguir mostra como usar o Write método para gravar 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.

Aplica-se a