XpsDocumentWriter.WriteAsync Metode

Definisi

Ruang nama:

System.Windows.Xps

Rakitan:

System.Printing.dll

Menulis secara asinkron ke XpsDocument atau PrintQueue yang membuat XpsDocumentWriter.

Overload

WriteAsync(FixedPage, Object)	Menulis secara asinkron yang ditentukan FixedPage ke target XpsDocument atau PrintQueue.
WriteAsync(FixedPage, PrintTicket)	Menulis secara asinkron yang ditentukan FixedPage bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(Visual, Object)	Menulis secara asinkron yang ditentukan Visual ke target XpsDocument atau PrintQueue.
WriteAsync(Visual, PrintTicket)	Menulis secara asinkron yang ditentukan Visual bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocumentSequence, PrintTicket, Object)	Menulis secara asinkron yang ditentukan FixedDocumentSequence bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocument, PrintTicket, Object)	Menulis secara asinkron yang ditentukan FixedDocument bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(FixedPage, PrintTicket, Object)	Menulis secara asinkron yang ditentukan FixedPage bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(Visual, PrintTicket, Object)	Menulis secara asinkron yang ditentukan Visual bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocumentSequence, PrintTicket)	Menulis secara asinkron yang ditentukan FixedDocumentSequence bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(DocumentPaginator, PrintTicket, Object)	Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocumentSequence, Object)	Menulis secara asinkron yang ditentukan FixedDocumentSequence ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocumentSequence)	Menulis secara asinkron yang ditentukan FixedDocumentSequence ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocument, Object)	Menulis secara asinkron yang ditentukan FixedDocument ke target XpsDocument atau PrintQueue.
WriteAsync(DocumentPaginator, PrintTicket)	Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.
WriteAsync(DocumentPaginator, Object)	Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator ke target XpsDocument atau PrintQueue.
WriteAsync(String, XpsDocumentNotificationLevel)	Menulis secara asinkron dokumen XPS tertentu dengan opsi pemberitahuan ke target XpsDocument atau PrintQueue.
WriteAsync(Visual)	Menulis secara asinkron yang ditentukan Visual ke target XpsDocument atau PrintQueue.
WriteAsync(FixedPage)	Menulis secara asinkron yang ditentukan FixedPage ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocument)	Menulis secara asinkron yang ditentukan FixedDocument ke target XpsDocument atau PrintQueue.
WriteAsync(DocumentPaginator)	Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator ke target XpsDocument atau PrintQueue.
WriteAsync(String)	Menulis secara asinkron dokumen XPS tertentu ke target XpsDocument atau PrintQueue.
WriteAsync(FixedDocument, PrintTicket)	Menulis secara asinkron yang ditentukan FixedDocument bersama dengan PrintTicket ke target XpsDocument atau PrintQueue.

WriteAsync(FixedPage, Object)

Menulis secara asinkron yang ditentukan FixedPage ke target XpsDocument atau 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)

Parameter

fixedPage

FixedPage

Halaman yang ditulis.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

WriteAsync(FixedPage, PrintTicket)

Menulis secara asinkron yang ditentukan FixedPage bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

fixedPage

FixedPage

Halaman yang ditulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk halaman.

Keterangan

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk tertentu PrintQueue. Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(FixedPage, PrintTicket).

WriteAsync(Visual, Object)

Menulis secara asinkron yang ditentukan Visual ke target XpsDocument atau 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)

Parameter

visual

Visual

Yang Visual tertulis.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

Untuk menulis Visualbatch , gunakan VisualsToXpsDocument.

WriteAsync(Visual, PrintTicket)

Menulis secara asinkron yang ditentukan Visual bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

visual

Visual

Yang Visual tertulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk dokumen.

Keterangan

Untuk menulis Visualbatch , gunakan VisualsToXpsDocument.

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk tertentu PrintQueue. Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(Visual, PrintTicket).

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Menulis secara asinkron yang ditentukan FixedDocumentSequence bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

fixedDocumentSequence

FixedDocumentSequence

Kumpulan dokumen yang akan ditulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk sekumpulan dokumen.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

WriteAsync menulis sekumpulan dokumen secara asinkron ke XpsDocument atau PrintQueue yang membuat XpsDocumentWriter. Data yang ditulis mencakup informasi tambahan PrintTicket dan yang ingin diteruskan pemanggil ke penanganan aktivitas.

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument atau sekumpulan FixedDocument elemen ke urutan yang ada.

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk tertentu PrintQueue. Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

WriteAsync(FixedDocument, PrintTicket, Object)

Menulis secara asinkron yang ditentukan FixedDocument bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

fixedDocument

FixedDocument

Dokumen yang ditulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk dokumen.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument ke set.

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk tertentu PrintQueue. Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

WriteAsync(FixedPage, PrintTicket, Object)

Menulis secara asinkron yang ditentukan FixedPage bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

fixedPage

FixedPage

Halaman yang ditulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk halaman.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk tertentu PrintQueue. Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

WriteAsync(Visual, PrintTicket, Object)

Menulis secara asinkron yang ditentukan Visual bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

visual

Visual

Yang Visual tertulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk dokumen.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

Untuk menulis beberapa Visual elemen, gunakan VisualsToXpsDocument.

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk .PrintQueue Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

WriteAsync(FixedDocumentSequence, PrintTicket)

Menulis secara asinkron yang ditentukan FixedDocumentSequence bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

fixedDocumentSequence

FixedDocumentSequence

Kumpulan dokumen yang ditulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk sekumpulan dokumen.

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument atau sekumpulan FixedDocument elemen ke set yang ada.

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk .PrintQueue Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(FixedDocumentSequence, PrintTicket).

WriteAsync(DocumentPaginator, PrintTicket, Object)

Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

documentPaginator

DocumentPaginator

Objek yang berisi penunjuk ke bahan sumber yang tidak dipaginasi; juga berisi metode untuk paginating bahan.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk bahan.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk .PrintQueue Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

WriteAsync(FixedDocumentSequence, Object)

Menulis secara asinkron yang ditentukan FixedDocumentSequence ke target XpsDocument atau 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)

Parameter

fixedDocumentSequence

FixedDocumentSequence

Kumpulan dokumen yang ditulis.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument atau sekumpulan FixedDocument elemen ke set yang ada.

WriteAsync(FixedDocumentSequence)

Menulis secara asinkron yang ditentukan FixedDocumentSequence ke target XpsDocument atau 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)

Parameter

fixedDocumentSequence

FixedDocumentSequence

Kumpulan dokumen yang ditulis.

Contoh

Contoh berikut menunjukkan cara menggunakan metode ini untuk menulis ke dokumen 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

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument atau sekumpulan FixedDocument elemen ke set yang ada.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(FixedDocumentSequence).

WriteAsync(FixedDocument, Object)

Menulis secara asinkron yang ditentukan FixedDocument ke target XpsDocument atau 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)

Parameter

fixedDocument

FixedDocument

Dokumen yang ditulis.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument ke set.

WriteAsync(DocumentPaginator, PrintTicket)

Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

documentPaginator

DocumentPaginator

Objek yang berisi penunjuk ke bahan sumber yang tidak disematkan dan juga berisi metode untuk paginating bahan.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk bahan.

Keterangan

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk .PrintQueue Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(DocumentPaginator, PrintTicket).

WriteAsync(DocumentPaginator, Object)

Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator ke target XpsDocument atau 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)

Parameter

documentPaginator

DocumentPaginator

Objek yang berisi penunjuk ke bahan sumber yang tidak dipaginasi; juga berisi metode untuk paginating bahan.

userSuppliedState

Object

Objek yang ditentukan pengguna untuk mengidentifikasi dan mengaitkan dengan operasi asinkron.

WriteAsync(String, XpsDocumentNotificationLevel)

Menulis secara asinkron dokumen XPS tertentu dengan opsi pemberitahuan ke target XpsDocument atau 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)

Parameter

documentPath

String

Jalur dokumen sumber.

notificationLevel

XpsDocumentNotificationLevel

Indikasi apakah pemberitahuan diaktifkan.

Keterangan

Ketika notificationLevel dinonaktifkan, XpsDocumentWriter menyalin dokumen XPS serial ke target XpsDocument atau PrintQueue yang membuat XpsDocumentWriter. Ketika notificationLevel diaktifkan, yang XpsDocumentWriter pertama mendeserialisasi dokumen, selanjutnya melakukan reserialisasi, lalu menulisnya ke target dengan pemberitahuan kemajuan karena setiap halaman adalah output.

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument elemen dalam sumber ke urutan FixedDocument elemen dalam target XpsDocument atau PrintQueue.

Jika notificationLevel ditentukan sebagai ReceiveNotificationEnabled, pemberitahuan hanya dihasilkan ketika dokumen diserialisasikan, bukan dicetak. Untuk menerima pemberitahuan, dokumen harus diserialisasi ulang. Saat dokumen direserialisasi, semua konten dari Package yang tidak diperlukan untuk dipertahankan oleh Spesifikasi Kertas XML dihapus. Reserialisasi juga menghapus semua ekstensi dari FixedPage markup, termasuk konten XPS yang diperluas.

Jika notificationLevel ditentukan sebagai ReceiveNotificationDisabled dokumen tidak akan direserialisasi dan konten yang diperluas akan dipertahankan, bahkan ketika dicetak.

Dengan mendesain metode ini WriteAsync tidak memanggil WritingPrintTicketRequired peristiwa.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(String, XpsDocumentNotificationLevel).

WriteAsync(Visual)

Menulis secara asinkron yang ditentukan Visual ke target XpsDocument atau 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)

Parameter

visual

Visual

Yang Visual ditulis.

Contoh

Contoh berikut menunjukkan cara menggunakan metode ini untuk menulis Visual ke dokumen 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

Keterangan

Untuk menulis Visualbatch , gunakan VisualsToXpsDocument.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(Visual).

WriteAsync(FixedPage)

Menulis secara asinkron yang ditentukan FixedPage ke target XpsDocument atau 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)

Parameter

fixedPage

FixedPage

Halaman yang ditulis.

Keterangan

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(FixedPage).

WriteAsync(FixedDocument)

Menulis secara asinkron yang ditentukan FixedDocument ke target XpsDocument atau 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)

Parameter

fixedDocument

FixedDocument

Dokumen yang ditulis.

Contoh

Contoh berikut menunjukkan cara menggunakan metode ini untuk menulis ke dokumen 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

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument ke set.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(FixedDocument).

WriteAsync(DocumentPaginator)

Menulis konten yang dipaginasi secara asinkron dari yang ditentukan DocumentPaginator ke target XpsDocument atau 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)

Parameter

documentPaginator

DocumentPaginator

Objek yang berisi penunjuk ke bahan sumber yang tidak disematkan dan juga berisi metode untuk paginating bahan.

Contoh

Contoh berikut menunjukkan cara menggunakan metode ini untuk menulis ke dokumen 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

Keterangan

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(DocumentPaginator).

WriteAsync(String)

Menulis secara asinkron dokumen XPS tertentu ke target XpsDocument atau PrintQueue.

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

public void WriteAsync (string documentPath);

override this.WriteAsync : string -> unit

Public Sub WriteAsync (documentPath As String)

Parameter

documentPath

String

Jalur dokumen sumber.

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument elemen dalam sumber ke kumpulan FixedDocument elemen dalam target XpsDocument atau PrintQueue.

Metode ini WriteAsync mereserialisasi dokumen XPS yang ditentukan, yang menghapus semua konten dari Package yang tidak perlu dipertahankan oleh Spesifikasi Kertas XML. Reserialisasi juga menghapus semua ekstensi dari FixedPage markup, termasuk konten XPS yang diperluas.

Secara desain, metode ini WriteAsync tidak memanggil WritingPrintTicketRequired peristiwa.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(String).

WriteAsync(FixedDocument, PrintTicket)

Menulis secara asinkron yang ditentukan FixedDocument bersama dengan PrintTicket ke target XpsDocument atau 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)

Parameter

fixedDocument

FixedDocument

Dokumen yang ditulis.

printTicket

PrintTicket

PrintTicket yang mewakili preferensi pencetakan default untuk dokumen.

Keterangan

XpsDocument Meskipun kelas memiliki nama tunggal, XpsDocument dapat berupa satu FixedDocument atau satu set beberapa dokumen. Metode ini menambahkan FixedDocument ke set.

Metode ini tidak memvalidasi atau memodifikasi yang ditentukan printTicket untuk .PrintQueue Jika perlu, gunakan MergeAndValidatePrintTicket metode untuk membuat PrintTicket yang khusus untuk PrintQueue dan valid untuk printer tertentu.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(FixedDocument, PrintTicket).