XpsDocumentWriter.WriteAsync 方法

参考

定义

命名空间:: System.Windows.Xps

程序集:: System.Printing.dll

重要

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

异步写入到创建 XpsDocumentWriter 的 XpsDocument 或 PrintQueue。

重载

WriteAsync(FixedPage, Object)	将指定的 FixedPage 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedPage, PrintTicket)	将指定的 FixedPage 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(Visual, Object)	将指定的 Visual 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(Visual, PrintTicket)	将指定的 Visual 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocumentSequence, PrintTicket, Object)	将指定的 FixedDocumentSequence 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocument, PrintTicket, Object)	将指定的 FixedDocument 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedPage, PrintTicket, Object)	将指定的 FixedPage 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(Visual, PrintTicket, Object)	将指定的 Visual 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocumentSequence, PrintTicket)	将指定的 FixedDocumentSequence 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(DocumentPaginator, PrintTicket, Object)	将分页内容从指定的 DocumentPaginator 和 PrintTicket 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocumentSequence, Object)	将指定的 FixedDocumentSequence 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocumentSequence)	将指定的 FixedDocumentSequence 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocument, Object)	将指定的 FixedDocument 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(DocumentPaginator, PrintTicket)	将分页内容从指定的 DocumentPaginator 和 PrintTicket 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(DocumentPaginator, Object)	将指定 DocumentPaginator 中的分页内容异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(String, XpsDocumentNotificationLevel)	将具有通知选项的指定 XPS 文档异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(Visual)	将指定的 Visual 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedPage)	将指定的 FixedPage 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocument)	将指定的 FixedDocument 异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(DocumentPaginator)	将指定 DocumentPaginator 中的分页内容异步写入目标 XpsDocument 或 PrintQueue。
WriteAsync(String)	以异步方式将指定的 XPS 文档写入目标 XpsDocument 或 PrintQueue。
WriteAsync(FixedDocument, PrintTicket)	将指定的 FixedDocument 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

WriteAsync(FixedPage, Object)

将指定的 FixedPage 异步写入目标 XpsDocument 或 PrintQueue。

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedPage * obj -> unit

Public Overrides Sub WriteAsync (fixedPage As FixedPage, userSuppliedState As Object)

参数

fixedPage: FixedPage

写入的页。

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

适用于

WriteAsync(FixedPage, PrintTicket)

将指定的 FixedPage 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedPage As FixedPage, printTicket As PrintTicket)

参数

fixedPage: FixedPage

写入的页。

printTicket: PrintTicket

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

注解

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(FixedPage, PrintTicket)异常。

适用于

WriteAsync(Visual, Object)

将指定的 Visual 异步写入目标 XpsDocument 或 PrintQueue。

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Media.Visual visual, object userSuppliedState);

override this.WriteAsync : System.Windows.Media.Visual * obj -> unit

Public Overrides Sub WriteAsync (visual As Visual, userSuppliedState As Object)

参数

visual: Visual

写入的 Visual。

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

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

适用于

WriteAsync(Visual, PrintTicket)

将指定的 Visual 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (visual As Visual, printTicket As PrintTicket)

参数

visual: Visual

写入的 Visual。

printTicket: PrintTicket

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

注解

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(Visual, PrintTicket)异常。

适用于

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

将指定的 FixedDocumentSequence 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, printTicket As PrintTicket, userSuppliedState As Object)

参数

fixedDocumentSequence: FixedDocumentSequence

要写入的文档集。

printTicket: PrintTicket

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

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

WriteAsync以异步方式将一组文档写入XpsDocument创建的 XpsDocumentWriter或 PrintQueue 。写入的数据包括 PrintTicket 调用方要传递给事件处理程序的和附加信息。

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

适用于

WriteAsync(FixedDocument, PrintTicket, Object)

将指定的 FixedDocument 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, printTicket As PrintTicket, userSuppliedState As Object)

参数

fixedDocument: FixedDocument

写入的文档。

printTicket: PrintTicket

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

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

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

适用于

WriteAsync(FixedPage, PrintTicket, Object)

将指定的 FixedPage 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedPage As FixedPage, printTicket As PrintTicket, userSuppliedState As Object)

参数

fixedPage: FixedPage

写入的页。

printTicket: PrintTicket

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

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

适用于

WriteAsync(Visual, PrintTicket, Object)

将指定的 Visual 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (visual As Visual, printTicket As PrintTicket, userSuppliedState As Object)

参数

visual: Visual

写入的 Visual。

printTicket: PrintTicket

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

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

若要编写多个 Visual 元素，请使用 VisualsToXpsDocument。

适用于

WriteAsync(FixedDocumentSequence, PrintTicket)

将指定的 FixedDocumentSequence 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, printTicket As PrintTicket)

参数

fixedDocumentSequence: FixedDocumentSequence

被写入的文档集。

printTicket: PrintTicket

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

注解

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(FixedDocumentSequence, PrintTicket)异常。

适用于

WriteAsync(DocumentPaginator, PrintTicket, Object)

将分页内容从指定的 DocumentPaginator 和 PrintTicket 异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, printTicket As PrintTicket, userSuppliedState As Object)

参数

documentPaginator: DocumentPaginator

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

printTicket: PrintTicket

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

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

适用于

WriteAsync(FixedDocumentSequence, Object)

将指定的 FixedDocumentSequence 异步写入目标 XpsDocument 或 PrintQueue。

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence * obj -> unit

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, userSuppliedState As Object)

参数

fixedDocumentSequence: FixedDocumentSequence

被写入的文档集。

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

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

适用于

WriteAsync(FixedDocumentSequence)

将指定的 FixedDocumentSequence 异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence)

参数

fixedDocumentSequence: FixedDocumentSequence

编写的文档集。

示例

以下示例演示如何使用此方法写入 XPS 文档。

private void SaveMultipleFixedContentDocumentsAsync(
             XpsDocumentWriter xpsdw, FixedDocumentSequence fds)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    xpsdw.WritingProgressChanged +=
        new WritingProgressChangedEventHandler(AsyncSavingProgress);

    // Write the FixedDocumentSequence as a
    // collection of documents asynchronously.
    xpsdw.WriteAsync(fds);
}

Private Sub SaveMultipleFixedContentDocumentsAsync(ByVal xpsdw As XpsDocumentWriter, ByVal fds As FixedDocumentSequence)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    AddHandler xpsdw.WritingProgressChanged, AddressOf AsyncSavingProgress

    ' Write the FixedDocumentSequence as a
    ' collection of documents asynchronously.
    xpsdw.WriteAsync(fds)
End Sub

注解

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(FixedDocumentSequence)异常。

适用于

WriteAsync(FixedDocument, Object)

将指定的 FixedDocument 异步写入目标 XpsDocument 或 PrintQueue。

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedDocument * obj -> unit

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, userSuppliedState As Object)

参数

fixedDocument: FixedDocument

写入的文档。

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

注解

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

适用于

WriteAsync(DocumentPaginator, PrintTicket)

将分页内容从指定的 DocumentPaginator 和 PrintTicket 异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, printTicket As PrintTicket)

参数

documentPaginator: DocumentPaginator

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

printTicket: PrintTicket

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

注解

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(DocumentPaginator, PrintTicket)异常。

适用于

WriteAsync(DocumentPaginator, Object)

将指定 DocumentPaginator 中的分页内容异步写入目标 XpsDocument 或 PrintQueue。

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.DocumentPaginator * obj -> unit

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, userSuppliedState As Object)

参数

documentPaginator: DocumentPaginator

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

userSuppliedState: Object

用户指定的对象，用于标识并关联异步操作。

适用于

WriteAsync(String, XpsDocumentNotificationLevel)

将具有通知选项的指定 XPS 文档异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

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

参数

documentPath: String

源文档的路径。

notificationLevel: XpsDocumentNotificationLevel

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

注解

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

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

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

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

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(String, XpsDocumentNotificationLevel)异常。

适用于

WriteAsync(Visual)

将指定的 Visual 异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (visual As Visual)

参数

visual: Visual

写入的 Visual。

示例

以下示例演示如何使用此方法将写入 Visual XPS 文档。

private void SaveVisualAsync(XpsDocumentWriter xpsdw, Visual v)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    xpsdw.WriteAsync(v);    // Write visual to single page.
}

Private Sub SaveVisualAsync(ByVal xpsdw As XpsDocumentWriter, ByVal v As Visual)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    xpsdw.WriteAsync(v) ' Write visual to single page.
End Sub

注解

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(Visual)异常。

适用于

WriteAsync(FixedPage)

将指定的 FixedPage 异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedPage As FixedPage)

参数

fixedPage: FixedPage

写入的页。

注解

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(FixedPage)异常。

适用于

WriteAsync(FixedDocument)

将指定的 FixedDocument 异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument)

参数

fixedDocument: FixedDocument

写入的文档。

示例

以下示例演示如何使用此方法写入 XPS 文档。

private void SaveSingleFixedContentDocumentAsync(
             XpsDocumentWriter xpsdw, FixedDocument fd)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the FixedDocument as a document.
    xpsdw.WriteAsync(fd);
}

Private Sub SaveSingleFixedContentDocumentAsync(ByVal xpsdw As XpsDocumentWriter, ByVal fd As FixedDocument)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    ' Write the FixedDocument as a document.
    xpsdw.WriteAsync(fd)
End Sub

注解

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(FixedDocument)异常。

适用于

WriteAsync(DocumentPaginator)

将指定 DocumentPaginator 中的分页内容异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator)

参数

documentPaginator: DocumentPaginator

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

示例

以下示例演示如何使用此方法写入 XPS 文档。

private void SaveSingleFlowContentDocumentAsync(
             XpsDocumentWriter xpsdw, DocumentPaginator idp)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the IDP as a document.
    xpsdw.WriteAsync(idp);
}

Private Sub SaveSingleFlowContentDocumentAsync(ByVal xpsdw As XpsDocumentWriter, ByVal idp As DocumentPaginator)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    ' Write the IDP as a document.
    xpsdw.WriteAsync(idp)
End Sub

注解

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(DocumentPaginator)异常。

适用于

WriteAsync(String)

以异步方式将指定的 XPS 文档写入目标 XpsDocument 或 PrintQueue。

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

public void WriteAsync (string documentPath);

override this.WriteAsync : string -> unit

Public Sub WriteAsync (documentPath As String)

参数

documentPath: String

源文档的路径。

注解

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

此方法 WriteAsync 重新序列化指定的 XPS 文档，这将删除 Package XML 纸张规范不需要保留的所有内容。重新序列化还会从 FixedPage 标记中删除所有扩展，包括任何扩展的 XPS 内容。

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

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(String)异常。

适用于

WriteAsync(FixedDocument, PrintTicket)

将指定的 FixedDocument 连同 PrintTicket 一起异步写入目标 XpsDocument 或 PrintQueue。

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

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

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

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, printTicket As PrintTicket)

参数

fixedDocument: FixedDocument

写入的文档。

printTicket: PrintTicket

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

注解

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

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

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 Write(FixedDocument, PrintTicket)异常。

适用于

通过

XpsDocumentWriter.WriteAsync 方法

定义

重载

WriteAsync(FixedPage, Object)

参数

适用于

WriteAsync(FixedPage, PrintTicket)

参数

注解

适用于

WriteAsync(Visual, Object)

参数

注解

适用于

WriteAsync(Visual, PrintTicket)

参数

注解

适用于

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

参数

注解

适用于

WriteAsync(FixedDocument, PrintTicket, Object)

参数

注解

适用于

WriteAsync(FixedPage, PrintTicket, Object)

参数

注解

适用于

WriteAsync(Visual, PrintTicket, Object)

参数

注解

适用于

WriteAsync(FixedDocumentSequence, PrintTicket)

参数

注解

适用于

WriteAsync(DocumentPaginator, PrintTicket, Object)

参数

注解

适用于

WriteAsync(FixedDocumentSequence, Object)

参数

注解

适用于

WriteAsync(FixedDocumentSequence)

参数

示例

注解

适用于

WriteAsync(FixedDocument, Object)

参数

注解

适用于

WriteAsync(DocumentPaginator, PrintTicket)

参数

注解

适用于

WriteAsync(DocumentPaginator, Object)

参数

适用于

WriteAsync(String, XpsDocumentNotificationLevel)

参数

注解

适用于

WriteAsync(Visual)

参数

示例

注解

适用于

WriteAsync(FixedPage)

参数

注解

适用于

WriteAsync(FixedDocument)

参数

示例

注解