XpsDocumentWriter.Write Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| Write(Visual, PrintTicket) |
Escreve sincronizadamente um especificado Visual juntamente com a PrintTicket para o destino XpsDocument ou PrintQueue. |
| Write(FixedPage, PrintTicket) |
Escreve sincronizadamente um especificado FixedPage juntamente com a PrintTicket para o destino XpsDocument ou PrintQueue. |
| Write(FixedDocumentSequence, PrintTicket) |
Escreve sincronizadamente um especificado FixedDocumentSequence juntamente com a PrintTicket para o destino XpsDocument ou PrintQueue. |
| Write(FixedDocument, PrintTicket) |
Escreve sincronizadamente a FixedDocument juntamente com a PrintTicket no destino XpsDocument ou PrintQueue. |
| Write(String, XpsDocumentNotificationLevel) |
Escreve síncronicamente um documento XPS especificado no destino XpsDocument ou PrintQueue. |
| Write(DocumentPaginator, PrintTicket) |
Escreve conteúdo paginado sincronizado de um especificado DocumentPaginator juntamente com a PrintTicket para o destino XpsDocument ou PrintQueue. |
| Write(FixedPage) |
Escreve sincronizadamente um especificado FixedPage para o destino XpsDocument ou PrintQueue. |
| Write(FixedDocumentSequence) |
Escreve sincronizadamente um especificado FixedDocumentSequence para o destino XpsDocument ou PrintQueue. |
| Write(FixedDocument) |
Escreve sincronizadamente um especificado FixedDocument para o destino XpsDocument ou PrintQueue. |
| Write(DocumentPaginator) |
Escreve conteúdo paginado sincronizado de um especificado DocumentPaginator para o destino XpsDocument ou PrintQueue. |
| Write(String) |
Escreve sincronizadamente um documento XPS especificado no destino XpsDocument ou PrintQueue. |
| Write(Visual) |
Escreve sincronizadamente um especificado Visual para o destino XpsDocument ou PrintQueue. |
Write(Visual, PrintTicket)
Escreve sincronizadamente um especificado Visual juntamente com a PrintTicket para o 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
- printTicket
- PrintTicket
A PrintTicket que representa as preferências de impressão padrão do documento.
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.
Aplica-se a
Write(FixedPage, PrintTicket)
Escreve sincronizadamente um especificado FixedPage juntamente com a PrintTicket para o 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
A PrintTicket que representa as preferências de impressão padrão da página.
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.
Aplica-se a
Write(FixedDocumentSequence, PrintTicket)
Escreve sincronizadamente um especificado FixedDocumentSequence juntamente com a PrintTicket para o 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 escritos.
- printTicket
- PrintTicket
A PrintTicket que representa as preferências de impressão padrão para o conjunto de documentos.
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.
Aplica-se a
Write(FixedDocument, PrintTicket)
Escreve sincronizadamente a FixedDocument juntamente com a 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
A PrintTicket que representa as preferências de impressão padrão do documento.
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.
Aplica-se a
Write(String, XpsDocumentNotificationLevel)
Escreve síncronicamente 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 percurso do documento de origem.
- notificationLevel
- XpsDocumentNotificationLevel
Uma indicação de se a notificação está ativada.
Observações
Quando notificationLevel está desativado, copia-se XpsDocumentWriter o documento serializadoXPS 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 (XPS) é 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 Write método não chama o WritingPrintTicketRequired evento.
Aplica-se a
Write(DocumentPaginator, PrintTicket)
Escreve conteúdo paginado sincronizado de um especificado DocumentPaginator juntamente com a 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 fonte não paginado e que também contém métodos para paginar o material.
- printTicket
- PrintTicket
A PrintTicket que representa as preferências de impressão padrão para o material.
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.
Aplica-se a
Write(FixedPage)
Escreve sincronizadamente um especificado 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 está escrita no XpsDocument.
Aplica-se a
Write(FixedDocumentSequence)
Escreve sincronizadamente um especificado 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 é escrito no XpsDocument.
Exemplos
O exemplo seguinte mostra como usar o Write método para escrever 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
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.
Aplica-se a
Write(FixedDocument)
Escreve sincronizadamente um especificado 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 é escrito para o XpsDocument.
Exemplos
O exemplo seguinte mostra como usar este método para escrever num 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
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.
Aplica-se a
Write(DocumentPaginator)
Escreve conteúdo paginado sincronizado 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 fonte não paginado e que também contém métodos para paginar o material.
Exemplos
O exemplo seguinte mostra como usar o Write método para escrever num 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)
Escreve sincronizadamente 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 percurso do documento de origem.
Observações
Embora a XpsDocumentWriter classe tenha um nome singular, an XpsDocumentWriter 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 XpsDocumentWriter ou PrintQueue.
Este Write 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 Write método não eleva o WritingPrintTicketRequired evento.
Aplica-se a
Write(Visual)
Escreve sincronizadamente um especificado 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
Exemplos
O exemplo seguinte mostra como usar o Write método para escrever a Visual num 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
Observações
Para escrever em lote um Visual, use VisualsToXpsDocument.