XpsDocumentWriter.WriteAsync Metoda

Definicja

Przestrzeń nazw:

System.Windows.Xps

Zestaw:

System.Printing.dll

Zapisuje asynchronicznie do XpsDocument elementu lub PrintQueue , który utworzył XpsDocumentWriterelement .

Przeciążenia

WriteAsync(FixedPage, Object)	Zapisuje asynchronicznie określony FixedPage obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(FixedPage, PrintTicket)	Zapisuje asynchronicznie określony FixedPage element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(Visual, Object)	Zapisuje asynchronicznie określony Visual obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(Visual, PrintTicket)	Zapisuje asynchronicznie określony Visual element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(FixedDocumentSequence, PrintTicket, Object)	Zapisuje asynchronicznie określony FixedDocumentSequence element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(FixedDocument, PrintTicket, Object)	Zapisuje asynchronicznie określony FixedDocument element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(FixedPage, PrintTicket, Object)	Zapisuje asynchronicznie określony FixedPage element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(Visual, PrintTicket, Object)	Zapisuje asynchronicznie określony Visual element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(FixedDocumentSequence, PrintTicket)	Zapisuje asynchronicznie określony FixedDocumentSequence element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(DocumentPaginator, PrintTicket, Object)	Zapisuje asynchronicznie z podziałem na strony zawartość z określonego DocumentPaginator obiektu razem z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(FixedDocumentSequence, Object)	Zapisuje asynchronicznie określony FixedDocumentSequence obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(FixedDocumentSequence)	Zapisuje asynchronicznie określony FixedDocumentSequence obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(FixedDocument, Object)	Zapisuje asynchronicznie określony FixedDocument obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(DocumentPaginator, PrintTicket)	Zapisuje asynchronicznie z podziałem na strony zawartość z określonego DocumentPaginator obiektu razem z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.
WriteAsync(DocumentPaginator, Object)	Zapisuje asynchronicznie z podziałem na strony zawartość z określonego DocumentPaginator obiektu docelowego XpsDocument lub PrintQueue.
WriteAsync(String, XpsDocumentNotificationLevel)	Zapisuje asynchronicznie określony dokument XPS z opcją powiadomienia do obiektu docelowego XpsDocument lub PrintQueue.
WriteAsync(Visual)	Zapisuje asynchronicznie określony Visual obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(FixedPage)	Zapisuje asynchronicznie określony FixedPage obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(FixedDocument)	Zapisuje asynchronicznie określony FixedDocument obiekt docelowy XpsDocument lub PrintQueue.
WriteAsync(DocumentPaginator)	Zapisuje asynchronicznie z podziałem na strony zawartość z określonego DocumentPaginator obiektu docelowego XpsDocument lub PrintQueue.
WriteAsync(String)	Zapisuje asynchronicznie określony dokument XPS do obiektu docelowego XpsDocument lub PrintQueue.
WriteAsync(FixedDocument, PrintTicket)	Zapisuje asynchronicznie określony FixedDocument element wraz z obiektem PrintTicket docelowym XpsDocument lub PrintQueue.

WriteAsync(FixedPage, Object)

Zapisuje asynchronicznie określony FixedPage obiekt docelowy XpsDocument lub 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

Strona, która jest napisana.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenia z operacją asynchroniczną.

WriteAsync(FixedPage, PrintTicket)

Zapisuje asynchronicznie określony FixedPage element wraz z obiektem PrintTicket docelowym XpsDocument lub 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

Strona, która jest napisana.

printTicket

PrintTicket

Obiekt PrintTicket reprezentujący domyślne preferencje drukowania dla strony.

Uwagi

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket elementu dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć obiekt PrintTicket specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Write(FixedPage, PrintTicket)usługę .

WriteAsync(Visual, Object)

Zapisuje asynchronicznie określony Visual obiekt docelowy XpsDocument lub 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 jest napisane.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenia z operacją asynchroniczną.

Uwagi

Aby zapisać wsadowe polecenie Visual, użyj polecenia VisualsToXpsDocument.

WriteAsync(Visual, PrintTicket)

Zapisuje asynchronicznie określony Visual element wraz z obiektem PrintTicket docelowym XpsDocument lub 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 jest napisane.

printTicket

PrintTicket

Obiekt PrintTicket reprezentujący domyślne preferencje drukowania dokumentu.

Uwagi

Aby zapisać wsadowe polecenie Visual, użyj polecenia VisualsToXpsDocument.

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket elementu dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć obiekt PrintTicket specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Write(Visual, PrintTicket)usługę .

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Zapisuje asynchronicznie określony FixedDocumentSequence element wraz z obiektem PrintTicket docelowym XpsDocument lub 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

Zestaw dokumentów do zapisania.

printTicket

PrintTicket

Obiekt PrintTicket reprezentujący domyślne preferencje drukowania dla zestawu dokumentów.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenia z operacją asynchroniczną.

Uwagi

WriteAsync zapisuje zestaw dokumentów asynchronicznie do obiektu XpsDocument lub PrintQueue , który utworzył element XpsDocumentWriter. Zapisane dane zawierają PrintTicket i dodatkowe informacje, które obiekt wywołujący chce przekazać do programu obsługi zdarzeń.

XpsDocument Chociaż klasa ma pojedynczą nazwę, XpsDocument może być jednym FixedDocument lub zestawem wielu dokumentów. Ta metoda dodaje FixedDocument zestaw FixedDocument elementów lub do istniejącej sekwencji.

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket elementu dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć obiekt PrintTicket specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

WriteAsync(FixedDocument, PrintTicket, Object)

Zapisuje asynchronicznie określony FixedDocument element wraz z obiektem PrintTicket docelowym XpsDocument lub 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

Napisany dokument.

printTicket

PrintTicket

Obiekt PrintTicket reprezentujący domyślne preferencje drukowania dokumentu.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenia z operacją asynchroniczną.

Uwagi

XpsDocument Chociaż klasa ma pojedynczą nazwę, XpsDocument może być jednym FixedDocument lub zestawem wielu dokumentów. Ta metoda dodaje element FixedDocument do zestawu.

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket elementu dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć obiekt PrintTicket specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

WriteAsync(FixedPage, PrintTicket, Object)

Zapisuje asynchronicznie określony FixedPage element wraz z obiektem PrintTicket docelowym XpsDocument lub 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

Strona, która jest napisana.

printTicket

PrintTicket

Obiekt PrintTicket reprezentujący domyślne preferencje drukowania dla strony.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenia z operacją asynchroniczną.

Uwagi

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket elementu dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć obiekt PrintTicket specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

WriteAsync(Visual, PrintTicket, Object)

Zapisuje asynchronicznie określony Visual element wraz z wartością PrintTicket docelową XpsDocument lub 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 jest napisane.

printTicket

PrintTicket

Obiekt PrintTicket reprezentujący domyślne preferencje drukowania dokumentu.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenia z operacją asynchroniczną.

Uwagi

Do pisania wielu Visual elementów użyj polecenia VisualsToXpsDocument.

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć PrintTicket element specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

WriteAsync(FixedDocumentSequence, PrintTicket)

Zapisuje asynchronicznie określony FixedDocumentSequence element wraz z wartością PrintTicket docelową XpsDocument lub 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

Zestaw zapisanych dokumentów.

printTicket

PrintTicket

Element PrintTicket reprezentujący domyślne preferencje drukowania dla zestawu dokumentów.

Uwagi

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje FixedDocument zestaw elementów lub do istniejącego FixedDocument zestawu.

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć PrintTicket element specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(FixedDocumentSequence, PrintTicket)usługę .

WriteAsync(DocumentPaginator, PrintTicket, Object)

Zapisuje asynchronicznie stronicowaną zawartość z określonej DocumentPaginator wartości wraz z wartością PrintTicket docelową XpsDocument lub 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

Obiekt zawierający wskaźnik do niepaginowanego materiału źródłowego; Zawiera również metody stronicowania materiału.

printTicket

PrintTicket

Element PrintTicket reprezentujący domyślne preferencje drukowania dla materiału.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenie z operacją asynchroniczną.

Uwagi

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć PrintTicket element specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

WriteAsync(FixedDocumentSequence, Object)

Zapisuje asynchronicznie określony FixedDocumentSequence element docelowy XpsDocument lub 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

Zestaw zapisanych dokumentów.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenie z operacją asynchroniczną.

Uwagi

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje FixedDocument zestaw elementów lub do istniejącego FixedDocument zestawu.

WriteAsync(FixedDocumentSequence)

Zapisuje asynchronicznie określony FixedDocumentSequence element docelowy XpsDocument lub 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

Zestaw zapisanych dokumentów.

Przykłady

W poniższym przykładzie pokazano, jak użyć tej metody do zapisu w dokumencie 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

Uwagi

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje FixedDocument zestaw elementów lub do istniejącego FixedDocument zestawu.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(FixedDocumentSequence)usługę .

WriteAsync(FixedDocument, Object)

Zapisuje asynchronicznie określony FixedDocument element docelowy XpsDocument lub 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, który jest napisany.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenie z operacją asynchroniczną.

Uwagi

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje element FixedDocument do zestawu.

WriteAsync(DocumentPaginator, PrintTicket)

Zapisuje asynchronicznie stronicowaną zawartość z określonej DocumentPaginator wartości wraz z wartością PrintTicket docelową XpsDocument lub 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

Obiekt, który zawiera wskaźnik do niepaginowanego materiału źródłowego, a także zawiera metody stronicowania materiału.

printTicket

PrintTicket

Element PrintTicket reprezentujący domyślne preferencje drukowania dla materiału.

Uwagi

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć PrintTicket element specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(DocumentPaginator, PrintTicket)usługę .

WriteAsync(DocumentPaginator, Object)

Zapisuje asynchronicznie stronicowaną zawartość z określonego elementu DocumentPaginator docelowego XpsDocument lub 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

Obiekt zawierający wskaźnik do niepaginowanego materiału źródłowego; Zawiera również metody stronicowania materiału.

userSuppliedState

Object

Obiekt określony przez użytkownika do identyfikowania i kojarzenie z operacją asynchroniczną.

WriteAsync(String, XpsDocumentNotificationLevel)

Zapisuje asynchronicznie określony dokument XPS z opcją powiadomienia do obiektu docelowego XpsDocument lub 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

Ścieżka dokumentu źródłowego.

notificationLevel

XpsDocumentNotificationLevel

Wskazanie, czy powiadomienie jest włączone.

Uwagi

Po notificationLevel wyłączeniu program XpsDocumentWriter kopiuje serializowany dokument XPS do obiektu docelowego XpsDocument lub PrintQueue utworzony przez program XpsDocumentWriter. Po notificationLevel włączeniu XpsDocumentWriter pierwszego deserializacji dokumentu, następnej reserializuje go, a następnie zapisuje go w miejscu docelowym z powiadomieniami o postępie, gdy każda strona jest danymi wyjściowymi.

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje FixedDocument elementy w źródle do sekwencji FixedDocument elementów w obiekcie docelowym XpsDocument lub PrintQueue.

Jeśli notificationLevel określono wartość ReceiveNotificationEnabled, powiadomienia są generowane tylko wtedy, gdy dokument jest serializowany, a nie drukowany. Aby otrzymywać powiadomienia, dokument musi być ponownie rozsyłany. Gdy dokument zostanie ponownie sformatowany, zostanie usunięta cała zawartość z Package dokumentu, która nie jest wymagana do zachowania przez specyfikację papieru XML . Ponowna synchronizacja usuwa również wszystkie rozszerzenia z FixedPage znaczników, w tym całą rozszerzoną zawartość XPS.

Jeśli notificationLevel zostanie określony jako ReceiveNotificationDisabled dokument, nie zostanie ponownie sformatowany, a każda rozszerzona zawartość zostanie zachowana, nawet po wydrukowaniu.

Zgodnie z projektem ta WriteAsync metoda nie wywołuje WritingPrintTicketRequired zdarzenia.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(String, XpsDocumentNotificationLevel)usługę .

WriteAsync(Visual)

Zapisuje asynchronicznie określony Visual element docelowy XpsDocument lub 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 jest napisane.

Przykłady

W poniższym przykładzie pokazano, jak użyć tej metody do zapisania dokumentu Visual XPS.

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

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

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

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

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

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

Uwagi

Aby wsadowy zapisać element Visual, użyj polecenia VisualsToXpsDocument.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(Visual)usługę .

WriteAsync(FixedPage)

Zapisuje asynchronicznie określony FixedPage element docelowy XpsDocument lub 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

Strona, która jest napisana.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(FixedPage)usługę .

WriteAsync(FixedDocument)

Zapisuje asynchronicznie określony FixedDocument element docelowy XpsDocument lub 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, który jest napisany.

Przykłady

W poniższym przykładzie pokazano, jak użyć tej metody do zapisu w dokumencie 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

Uwagi

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje element FixedDocument do zestawu.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(FixedDocument)usługę .

WriteAsync(DocumentPaginator)

Zapisuje asynchronicznie stronicowaną zawartość z określonego elementu DocumentPaginator docelowego XpsDocument lub 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

Obiekt, który zawiera wskaźnik do niepaginowanego materiału źródłowego, a także zawiera metody stronicowania materiału.

Przykłady

W poniższym przykładzie pokazano, jak użyć tej metody do zapisu w dokumencie 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

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(DocumentPaginator)usługę .

WriteAsync(String)

Zapisuje asynchronicznie określony dokument XPS do obiektu docelowego XpsDocument lub 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

Ścieżka dokumentu źródłowego.

Uwagi

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje FixedDocument elementy w źródle do zestawu FixedDocument elementów w obiekcie docelowym XpsDocument lub PrintQueue.

Ta WriteAsync metoda reerializuje określony dokument XPS, który usuwa całą zawartość z Package tego dokumentu, który nie jest wymagany do zachowania przez specyfikację papieru XML. Ponowna synchronizacja usuwa również wszystkie rozszerzenia z FixedPage znaczników, w tym całą rozszerzoną zawartość XPS.

Zgodnie z projektem ta WriteAsync metoda nie wywołuje WritingPrintTicketRequired zdarzenia.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(String)usługę .

WriteAsync(FixedDocument, PrintTicket)

Zapisuje asynchronicznie określony FixedDocument element wraz z wartością PrintTicket docelową XpsDocument lub 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, który jest napisany.

printTicket

PrintTicket

Element PrintTicket reprezentujący domyślne preferencje drukowania dla dokumentu.

Uwagi

XpsDocument Mimo że klasa ma pojedynczą nazwę, XpsDocument może to być jeden FixedDocument lub zestaw wielu dokumentów. Ta metoda dodaje element FixedDocument do zestawu.

Ta metoda nie weryfikuje ani nie modyfikuje określonego printTicket dla określonego PrintQueueelementu . W razie potrzeby użyj MergeAndValidatePrintTicket metody , aby utworzyć PrintTicket element specyficzny dla PrintQueue elementu i jest prawidłowy dla określonej drukarki.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Write(FixedDocument, PrintTicket)usługę .