Partilhar via


XpsDocumentWriter.Write Método

Definição

Sobrecargas

Write(Visual, PrintTicket)

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

Write(FixedPage, PrintTicket)

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

Write(FixedDocumentSequence, PrintTicket)

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

Write(FixedDocument, PrintTicket)

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

Write(String, XpsDocumentNotificationLevel)

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

Write(DocumentPaginator, PrintTicket)

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

Write(FixedPage)

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

Write(FixedDocumentSequence)

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

Write(FixedDocument)

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

Write(DocumentPaginator)

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

Write(String)

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

Write(Visual)

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

Write(Visual, PrintTicket)

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

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

Aplica-se a

Write(FixedPage, PrintTicket)

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

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

Aplica-se a

Write(FixedDocumentSequence, PrintTicket)

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

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

Aplica-se a

Write(FixedDocument, PrintTicket)

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

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

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 se a notificação está habilitada.

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 .

Aplica-se a

Write(DocumentPaginator, PrintTicket)

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

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

Aplica-se a

Write(FixedPage)

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

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 é gravada no XpsDocument.

Aplica-se a

Write(FixedDocumentSequence)

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

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

Aplica-se a

Write(FixedDocument)

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

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

Aplica-se a

Write(DocumentPaginator)

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

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

Aplica-se a

Write(Visual)

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

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 é gravado.

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.

Aplica-se a