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)	改ページ調整された内容を PrintTicket とともに指定した DocumentPaginator からターゲットの XpsDocument または PrintQueue に非同期で書き込みます。
WriteAsync(FixedDocumentSequence, Object)	指定した FixedDocumentSequence をターゲットの XpsDocument または PrintQueue に非同期で書き込みます。
WriteAsync(FixedDocumentSequence)	指定した FixedDocumentSequence をターゲットの XpsDocument または PrintQueue に非同期で書き込みます。
WriteAsync(FixedDocument, Object)	指定した FixedDocument をターゲットの XpsDocument または PrintQueue に非同期で書き込みます。
WriteAsync(DocumentPaginator, PrintTicket)	改ページ調整された内容を PrintTicket とともに指定した DocumentPaginator からターゲットの 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 PrintQueue一連のドキュメントをXpsDocumentWriter書き込みます。書き込まれるデータには、と、呼び出し元がイベントハンドラーに渡す追加情報が含まれます PrintTicket 。

クラスには XpsDocument 単数形の名前がありますが、 XpsDocument には 1 つまたは 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 には 1 つまたは 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 には 1 つまたは FixedDocument 複数のドキュメントのセットを指定できます。このメソッドは、 FixedDocument または要素のセットを既存の FixedDocument セットに追加します。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。などの ArgumentException使用例外は、引き続き同期的にスローされます。格納されている例外については、によって Write(FixedDocumentSequence, PrintTicket)スローされる例外に関するページを参照してください。

適用対象

WriteAsync(DocumentPaginator, PrintTicket, Object)

改ページ調整された内容を PrintTicket とともに指定した DocumentPaginator からターゲットの 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

非同期操作を識別し、それに関連付けるユーザー指定のオブジェクト。

注釈

適用対象

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

注釈

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。などの 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

非同期操作を識別し、それに関連付けるユーザー指定のオブジェクト。

注釈

適用対象

WriteAsync(DocumentPaginator, PrintTicket)

改ページ調整された内容を PrintTicket とともに指定した DocumentPaginator からターゲットの 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

通知が有効になっているかどうかを示す値。

注釈

が無効になっている場合、はXpsDocumentWriterシリアル化された XPS ドキュメントをターゲットXpsDocumentにコピーするかPrintQueue、を作成したをコピーしますXpsDocumentWriter。notificationLevel が有効になっている場合 notificationLevel 、最初の XpsDocumentWriter はドキュメントを逆シリアル化し、次にドキュメントを再シリアル化してから、各ページが出力されるときに進行状況通知を使用してターゲットに書き込みます。

クラスには XpsDocument 単数形の名前がありますが、 XpsDocument には 1 つまたは FixedDocument 複数のドキュメントのセットを指定できます。このメソッドは、FixedDocumentソース内の要素をターゲットXpsDocumentまたは PrintQueue内の要素のFixedDocumentシーケンスに追加します。

がとしてReceiveNotificationEnabled指定されている場合notificationLevel、通知はドキュメントがシリアル化されたときにのみ生成され、印刷されません。通知を受信するには、ドキュメントを再送信する必要があります。ドキュメントが再シリアル化されると、XML Paper Specification で保持する必要のないからのすべてのコンテンツPackageが削除されます。再読み込みでは、拡張 XPS コンテンツを FixedPage 含め、マークアップからすべての拡張機能も削除されます。

が指定されているReceiveNotificationDisabled場合notificationLevel、ドキュメントは再シリアル化されず、印刷された場合でも拡張コンテンツは保持されます。

設計上、この 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。

例

次の例は、このメソッドを使用して XPS ドキュメントにを Visual 書き込む方法を示しています。

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

注釈

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。などの 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 には 1 つまたは複数 FixedDocument のドキュメントのセットを指定できます。このメソッドは、FixedDocumentソース内の要素をターゲットXpsDocumentまたは PrintQueue内の要素のFixedDocumentセットに追加します。

このメソッドはWriteAsync、指定された XPS ドキュメントを再シリアル化します。これにより、XML Paper Specification で保持する必要のないすべてのコンテンツがからPackage削除されます。再配信では、拡張 XPS コンテンツを含め、マークアップから FixedPage すべての拡張機能も削除されます。

設計上、この 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 には 1 つまたは複数 FixedDocument のドキュメントのセットを指定できます。このメソッドは、をセットに追加 FixedDocument します。

このメソッドは、特定PrintQueueのに対して指定された printTicket を検証または変更しません。必要に応じて、メソッドをMergeAndValidatePrintTicket使用して、に固有で、指定したプリンターに対してPrintQueue有効なを作成PrintTicketします。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。などの ArgumentException使用例外は、引き続き同期的にスローされます。格納されている例外については、によって Write(FixedDocument, PrintTicket)スローされる例外に関するページを参照してください。

適用対象