XpsDocumentWriter.Write 方法

参考

定义

命名空间:: System.Windows.Xps

程序集:: System.Printing.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

Write(Visual, PrintTicket)	将指定的 Visual 和 PrintTicket 一起同步写入目标 XpsDocument 或 PrintQueue。
Write(FixedPage, PrintTicket)	将指定的 FixedPage 和 PrintTicket 一起同步写入目标 XpsDocument 或 PrintQueue。
Write(FixedDocumentSequence, PrintTicket)	将指定的 FixedDocumentSequence 和 PrintTicket 一起同步写入目标 XpsDocument 或 PrintQueue。
Write(FixedDocument, PrintTicket)	将 FixedDocument 和 PrintTicket 一起同步写入目标 XpsDocument 或 PrintQueue。
Write(String, XpsDocumentNotificationLevel)	将指定的 XPS 文档同步写入目标 XpsDocument 或 PrintQueue。
Write(DocumentPaginator, PrintTicket)	将分页内容从指定的 DocumentPaginator 和 PrintTicket 同步写入目标 XpsDocument 或 PrintQueue。
Write(FixedPage)	将指定的 FixedPage 同步写入到目标 XpsDocument 或 PrintQueue。
Write(FixedDocumentSequence)	将指定的 FixedDocumentSequence 同步写入到目标 XpsDocument 或 PrintQueue。
Write(FixedDocument)	将指定的 FixedDocument 同步写入到目标 XpsDocument 或 PrintQueue。
Write(DocumentPaginator)	将指定 DocumentPaginator 中的分页内容同步写入目标 XpsDocument 或 PrintQueue。
Write(String)	将指定的 XPS 文档同步写入目标 XpsDocument 或 PrintQueue。
Write(Visual)	将指定的 Visual 同步写入到目标 XpsDocument 或 PrintQueue。

Write(Visual, PrintTicket)

将指定的 Visual 和 PrintTicket 一起同步写入目标 XpsDocument 或 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)

参数

visual: Visual

写入的 Visual。

printTicket: PrintTicket

一个 PrintTicket，它表示文档的默认打印首选项。

注解

若要批量写入 Visual，请使用 VisualsToXpsDocument。

此方法不会验证或修改为特定 PrintQueue指定的 printTicket 。如有必要，请使用 MergeAndValidatePrintTicket 方法创建 PrintTicket 特定于 PrintQueue 且对指定打印机有效的。

适用于

Write(FixedPage, PrintTicket)

将指定的 FixedPage 和 PrintTicket 一起同步写入目标 XpsDocument 或 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)

参数

fixedPage: FixedPage

写入的页。

printTicket: PrintTicket

一个 PrintTicket，它表示页的默认打印首选项。

注解

适用于

Write(FixedDocumentSequence, PrintTicket)

将指定的 FixedDocumentSequence 和 PrintTicket 一起同步写入目标 XpsDocument 或 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)

参数

fixedDocumentSequence: FixedDocumentSequence

被写入的文档集。

printTicket: PrintTicket

一个 PrintTicket，它表示文档集的默认打印首选项。

注解

XpsDocument尽管类具有单一名称，但 XpsDocument 可以是一个FixedDocument或一组多个文档。此方法将 FixedDocument 或一组 FixedDocument 元素添加到现有集。

适用于

Write(FixedDocument, PrintTicket)

将 FixedDocument 和 PrintTicket 一起同步写入目标 XpsDocument 或 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)

参数

fixedDocument: FixedDocument

写入的文档。

printTicket: PrintTicket

一个 PrintTicket，它表示文档的默认打印首选项。

注解

XpsDocument尽管类具有单一名称，但 XpsDocument 可以是一个FixedDocument或一组多个文档。此方法将添加到 FixedDocument 集中。

适用于

Write(String, XpsDocumentNotificationLevel)

将指定的 XPS 文档同步写入目标 XpsDocument 或 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)

参数

documentPath: String

源文档的路径。

notificationLevel: XpsDocumentNotificationLevel

对是否已启用通知的指示。

注解

禁用时 notificationLevel ， XpsDocumentWriter 会将 serializedXPS 文档复制到目标 XpsDocument 或 PrintQueue 创建的 XpsDocumentWriter。启用后 notificationLevel ， XpsDocumentWriter 第一个将反序列化文档，然后重新序列化文档，然后在输出每个页面时将其写入目标，并显示进度通知。

XpsDocument尽管类具有单一名称，但 XpsDocument 可以是一个FixedDocument或一组多个文档。此方法将FixedDocument源中的元素添加到目标XpsDocument或 PrintQueue中的元素序列FixedDocument中。

如果 notificationLevel 指定为 ReceiveNotificationEnabled，则仅在序列化文档时生成通知，而不是打印。若要接收通知，必须重新序列化文档。重新序列化文档时，将删除 XML 纸张规范 (XPS) 不需要保留的中的所有内容Package。重新序列化还会从 FixedPage 标记中删除所有扩展，包括任何扩展的 XPS 内容。

如果 notificationLevel 指定为 ReceiveNotificationDisabled ，则不会重新序列化文档，并且将保留任何扩展内容，即使在打印时也是如此。

根据设计，此方法 Write 不调用 WritingPrintTicketRequired 事件。

适用于

Write(DocumentPaginator, PrintTicket)

将分页内容从指定的 DocumentPaginator 和 PrintTicket 同步写入目标 XpsDocument 或 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)

参数

documentPaginator: DocumentPaginator

包含指向未分页源材料的指针并包含材料分页方法的对象。

printTicket: PrintTicket

一个 PrintTicket，表示材料的默认打印首选项。

注解

适用于

Write(FixedPage)

将指定的 FixedPage 同步写入到目标 XpsDocument 或 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)

参数

fixedPage: FixedPage

写入 XpsDocument 的页面。

适用于

Write(FixedDocumentSequence)

将指定的 FixedDocumentSequence 同步写入到目标 XpsDocument 或 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)

参数

fixedDocumentSequence: FixedDocumentSequence

写入 XpsDocument 的文档集。

示例

以下示例演示如何使用 Write 方法编写 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

注解

XpsDocument尽管类具有单一名称，但 XpsDocument 可以是一个FixedDocument或一组多个文档。此方法将 FixedDocument 或一组 FixedDocument 元素添加到现有集。

适用于

Write(FixedDocument)

将指定的 FixedDocument 同步写入到目标 XpsDocument 或 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)

参数

fixedDocument: FixedDocument

写入 XpsDocument 的文档。

示例

以下示例演示如何使用此方法写入 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

注解

XpsDocument尽管类具有单一名称，但 XpsDocument 可以是一个FixedDocument或一组多个文档。此方法将添加到 FixedDocument 集中。

适用于

Write(DocumentPaginator)

将指定 DocumentPaginator 中的分页内容同步写入目标 XpsDocument 或 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)

参数

documentPaginator: DocumentPaginator

包含指向未分页源材料的指针并包含材料分页方法的对象。

示例

以下示例演示如何使用 Write 方法写入 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

适用于

Write(String)