XpsDocumentWriter.WriteAsync Metoda

Definice

Obor názvů:

System.Windows.Xps

Sestavení:

System.Printing.dll

Zapisuje asynchronně do objektu XpsDocument nebo PrintQueue , který vytvořil .XpsDocumentWriter

Přetížení

WriteAsync(FixedPage, Object)	Zapíše asynchronně zadaný FixedPage objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedPage, PrintTicket)	Zapíše asynchronně zadaný společně FixedPage s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(Visual, Object)	Zapíše asynchronně zadaný Visual objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(Visual, PrintTicket)	Zapíše asynchronně zadaný společně Visual s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocumentSequence, PrintTicket, Object)	Zapíše asynchronně zadaný společně FixedDocumentSequence s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocument, PrintTicket, Object)	Zapíše asynchronně zadaný společně FixedDocument s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedPage, PrintTicket, Object)	Zapíše asynchronně zadaný společně FixedPage s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(Visual, PrintTicket, Object)	Zapíše asynchronně zadaný společně Visual s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocumentSequence, PrintTicket)	Zapíše asynchronně zadaný společně FixedDocumentSequence s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(DocumentPaginator, PrintTicket, Object)	Zapíše asynchronně stránkovaný obsah ze zadaného DocumentPaginator společně s objektem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocumentSequence, Object)	Zapíše asynchronně zadaný FixedDocumentSequence objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocumentSequence)	Zapíše asynchronně zadaný FixedDocumentSequence objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocument, Object)	Zapíše asynchronně zadaný FixedDocument objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(DocumentPaginator, PrintTicket)	Zapíše asynchronně stránkovaný obsah ze zadaného DocumentPaginator společně s objektem PrintTicket do cíle XpsDocument nebo PrintQueue.
WriteAsync(DocumentPaginator, Object)	Zapisuje asynchronně stránkovaný obsah ze zadaného DocumentPaginator objektu do cíle XpsDocument nebo PrintQueue.
WriteAsync(String, XpsDocumentNotificationLevel)	Zapíše asynchronně zadaný dokument XPS s možností oznámení do cíle XpsDocument nebo PrintQueue.
WriteAsync(Visual)	Zapíše asynchronně zadaný Visual objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedPage)	Zapíše asynchronně zadaný FixedPage objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocument)	Zapíše asynchronně zadaný FixedDocument objekt do cíle XpsDocument nebo PrintQueue.
WriteAsync(DocumentPaginator)	Zapisuje asynchronně stránkovaný obsah ze zadaného DocumentPaginator objektu do cíle XpsDocument nebo PrintQueue.
WriteAsync(String)	Zapíše asynchronně zadaný dokument XPS do cíle XpsDocument nebo PrintQueue.
WriteAsync(FixedDocument, PrintTicket)	Zapíše asynchronně zadaný společně FixedDocument s parametrem PrintTicket do cíle XpsDocument nebo PrintQueue.

WriteAsync(FixedPage, Object)

Zapíše asynchronně zadaný FixedPage objekt do cíle XpsDocument nebo 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)

Parametry

fixedPage

FixedPage

Stránka, která je napsaná.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

WriteAsync(FixedPage, PrintTicket)

Zapíše asynchronně zadaný společně FixedPage s parametrem PrintTicket do cíle XpsDocument nebo 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)

Parametry

fixedPage

FixedPage

Stránka, která je napsaná.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku stránky.

Poznámky

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(FixedPage, PrintTicket).

WriteAsync(Visual, Object)

Zapíše asynchronně zadaný Visual objekt do cíle XpsDocument nebo 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)

Parametry

visual

Visual

To Visual , co je napsané.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

K dávkovému zápisu Visualpoužijte VisualsToXpsDocument.

WriteAsync(Visual, PrintTicket)

Zapíše asynchronně zadaný společně Visual s parametrem PrintTicket do cíle XpsDocument nebo 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)

Parametry

visual

Visual

To Visual , co je napsané.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro dokument.

Poznámky

K dávkovému zápisu Visualpoužijte VisualsToXpsDocument.

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(Visual, PrintTicket).

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Zapíše asynchronně zadaný společně FixedDocumentSequence s parametrem PrintTicket do cíle XpsDocument nebo 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)

Parametry

fixedDocumentSequence

FixedDocumentSequence

Sada dokumentů, které se mají zapsat.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro sadu dokumentů.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

WriteAsync zapíše sadu dokumentů asynchronně do objektu XpsDocument nebo PrintQueue , který vytvořil XpsDocumentWriter. Zapsaná data obsahují PrintTicket další informace a, které volající chce předat obslužné rutině události.

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument nebo sadu FixedDocument prvků do existující sekvence.

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

WriteAsync(FixedDocument, PrintTicket, Object)

Zapíše asynchronně zadaný společně FixedDocument s parametrem PrintTicket do cíle XpsDocument nebo 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)

Parametry

fixedDocument

FixedDocument

Dokument, který je napsán.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro dokument.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument do sady .

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

WriteAsync(FixedPage, PrintTicket, Object)

Zapíše asynchronně zadaný společně FixedPage s parametrem PrintTicket do cíle XpsDocument nebo 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)

Parametry

fixedPage

FixedPage

Stránka, která je napsaná.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku stránky.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

WriteAsync(Visual, PrintTicket, Object)

Zapíše asynchronně zadaný společně Visual s parametrem PrintTicket do cíle XpsDocument nebo 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)

Parametry

visual

Visual

To Visual , co je napsané.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro dokument.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

Pro zápis více Visual prvků použijte VisualsToXpsDocument.

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

WriteAsync(FixedDocumentSequence, PrintTicket)

Zapíše asynchronně zadaný společně FixedDocumentSequence s parametrem PrintTicket do cíle XpsDocument nebo 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)

Parametry

fixedDocumentSequence

FixedDocumentSequence

Sada dokumentů, které jsou napsány.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro sadu dokumentů.

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument do existující sady elementů FixedDocument nebo sadu prvků.

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(FixedDocumentSequence, PrintTicket).

WriteAsync(DocumentPaginator, PrintTicket, Object)

Zapíše asynchronně stránkovaný obsah ze zadaného DocumentPaginator společně s objektem PrintTicket do cíle XpsDocument nebo 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)

Parametry

documentPaginator

DocumentPaginator

Objekt, který obsahuje ukazatel na nepagrovaný zdrojový materiál; obsahuje také metody pro stránkování materiálu.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro materiál.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

WriteAsync(FixedDocumentSequence, Object)

Zapíše asynchronně zadaný FixedDocumentSequence objekt do cíle XpsDocument nebo 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)

Parametry

fixedDocumentSequence

FixedDocumentSequence

Sada dokumentů, které jsou napsány.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument do existující sady elementů FixedDocument nebo sadu prvků.

WriteAsync(FixedDocumentSequence)

Zapíše asynchronně zadaný FixedDocumentSequence objekt do cíle XpsDocument nebo 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)

Parametry

fixedDocumentSequence

FixedDocumentSequence

Sada dokumentů, která je napsána.

Příklady

Následující příklad ukazuje, jak použít tuto metodu k zápisu do dokumentu 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

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument do existující sady elementů FixedDocument nebo sadu prvků.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(FixedDocumentSequence).

WriteAsync(FixedDocument, Object)

Zapíše asynchronně zadaný FixedDocument objekt do cíle XpsDocument nebo 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)

Parametry

fixedDocument

FixedDocument

Dokument, který je napsán.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument do sady .

WriteAsync(DocumentPaginator, PrintTicket)

Zapíše asynchronně stránkovaný obsah ze zadaného DocumentPaginator společně s objektem PrintTicket do cíle XpsDocument nebo 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)

Parametry

documentPaginator

DocumentPaginator

Objekt, který obsahuje ukazatel na nepagrovaný zdrojový materiál a obsahuje také metody pro stránkování materiálu.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro materiál.

Poznámky

Tato metoda neověřuje ani neupravuje zadané printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(DocumentPaginator, PrintTicket).

WriteAsync(DocumentPaginator, Object)

Zapisuje asynchronně stránkovaný obsah ze zadaného DocumentPaginator objektu do cíle XpsDocument nebo 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)

Parametry

documentPaginator

DocumentPaginator

Objekt, který obsahuje ukazatel na nepagrovaný zdrojový materiál; obsahuje také metody pro stránkování materiálu.

userSuppliedState

Object

Objekt zadaný uživatelem, který se má identifikovat a přidružit k asynchronní operaci.

WriteAsync(String, XpsDocumentNotificationLevel)

Zapíše asynchronně zadaný dokument XPS s možností oznámení do cíle XpsDocument nebo 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)

Parametry

documentPath

String

Cesta ke zdrojovému dokumentu.

notificationLevel

XpsDocumentNotificationLevel

Údaj o tom, jestli je oznámení povolené.

Poznámky

Pokud notificationLevel je zakázán, XpsDocumentWriter zkopíruje serializovaný dokument XPS do cíle XpsDocument nebo PrintQueue , který vytvořil XpsDocumentWriter. Když notificationLevel je povolená, XpsDocumentWriter první dokument deserializuje, pak ho znovu zapíše do cíle s oznámeními o průběhu, protože každá stránka je výstupem.

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá elementy FixedDocument ve zdroji do posloupnosti FixedDocument prvků v cíli XpsDocument nebo PrintQueue.

Pokud notificationLevel je zadán jako ReceiveNotificationEnabled, oznámení se vytvoří pouze v případě, že je dokument serializován, ne vytištěn. Pokud chcete dostávat oznámení, musí být dokument znovu reerializován. Při reserializaci dokumentu se odebere veškerý obsah z objektu Package , který není nutné zachovat podle specifikace PAPÍRU XML . Reserializace také odebere všechna rozšíření ze FixedPage značek, včetně veškerého rozšířeného obsahu XPS.

Pokud notificationLevel je zadáno, dokument ReceiveNotificationDisabled nebude znovu reerializován a veškerý rozšířený obsah bude zachován, i když je vytištěn.

Tato WriteAsync metoda záměrně nevolá WritingPrintTicketRequired událost.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(String, XpsDocumentNotificationLevel).

WriteAsync(Visual)

Zapíše asynchronně zadaný Visual objekt do cíle XpsDocument nebo 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)

Parametry

visual

Visual

To Visual , co je napsané.

Příklady

Následující příklad ukazuje, jak použít tuto metodu k zápisu Visual do dokumentu 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

Poznámky

K dávkovému zápisu Visualpoužijte VisualsToXpsDocument.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(Visual).

WriteAsync(FixedPage)

Zapíše asynchronně zadaný FixedPage objekt do cíle XpsDocument nebo 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)

Parametry

fixedPage

FixedPage

Stránka, která je napsaná.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(FixedPage).

WriteAsync(FixedDocument)

Zapíše asynchronně zadaný FixedDocument objekt do cíle XpsDocument nebo 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)

Parametry

fixedDocument

FixedDocument

Dokument, který je napsán.

Příklady

Následující příklad ukazuje, jak použít tuto metodu k zápisu do dokumentu 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

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument do sady .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(FixedDocument).

WriteAsync(DocumentPaginator)

Zapisuje asynchronně stránkovaný obsah ze zadaného DocumentPaginator objektu do cíle XpsDocument nebo 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)

Parametry

documentPaginator

DocumentPaginator

Objekt, který obsahuje ukazatel na nepagrovaný zdrojový materiál a obsahuje také metody pro stránkování materiálu.

Příklady

Následující příklad ukazuje, jak použít tuto metodu k zápisu do dokumentu 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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(DocumentPaginator).

WriteAsync(String)

Zapíše asynchronně zadaný dokument XPS do cíle XpsDocument nebo PrintQueue.

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

public void WriteAsync (string documentPath);

override this.WriteAsync : string -> unit

Public Sub WriteAsync (documentPath As String)

Parametry

documentPath

String

Cesta ke zdrojovému dokumentu.

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá elementy FixedDocument ve zdroji do sady FixedDocument prvků v cíli XpsDocument nebo PrintQueue.

Tato WriteAsync metoda přeeerializuje zadaný dokument XPS, který odebere veškerý obsah z Package , který není nutné zachovat specifikace dokumentu XML. Reserializace také odebere všechna rozšíření z FixedPage kódu, včetně veškerého rozšířeného obsahu XPS.

Tato WriteAsync metoda záměrně nevolá WritingPrintTicketRequired událost.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(String).

WriteAsync(FixedDocument, PrintTicket)

Zapíše asynchronně zadaný společně FixedDocument s parametrem do PrintTicket cíle XpsDocument nebo 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)

Parametry

fixedDocument

FixedDocument

Dokument, který je napsán.

printTicket

PrintTicket

A PrintTicket , který představuje výchozí předvolby tisku pro dokument.

Poznámky

XpsDocument I když má třída jednotný název, XpsDocument může být jeden FixedDocument nebo sada více dokumentů. Tato metoda přidá FixedDocument do sady .

Tato metoda neověřuje ani neupravuje zadaná printTicket pro konkrétní PrintQueue. V případě potřeby vytvořte metodu MergeAndValidatePrintTicketPrintTicket , která je specifická pro PrintQueue a je platná pro zadanou tiskárnu.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(FixedDocument, PrintTicket).