XpsDocumentWriter.WriteAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Schrijft asynchroon naar de XpsDocument of PrintQueue die de XpsDocumentWriter.
Overloads
WriteAsync(FixedPage, Object)
Schrijft asynchroon een opgegeven FixedPage naar het doel XpsDocument of 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)
Parameters
- fixedPage
- FixedPage
De pagina die is geschreven.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Van toepassing op
WriteAsync(FixedPage, PrintTicket)
Schrijft asynchroon een opgegeven FixedPage samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- fixedPage
- FixedPage
De pagina die is geschreven.
- printTicket
- PrintTicket
Een PrintTicket die de standaardvoorkeuren voor afdrukken voor de pagina vertegenwoordigt.
Opmerkingen
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(FixedPage, PrintTicket)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(Visual, Object)
Schrijft asynchroon een opgegeven Visual naar het doel XpsDocument of 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)
Parameters
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
Als u een Visualbatch wilt schrijven, gebruikt u VisualsToXpsDocument.
Van toepassing op
WriteAsync(Visual, PrintTicket)
Schrijft asynchroon een opgegeven Visual samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor het document vertegenwoordigt.
Opmerkingen
Als u een Visualbatch wilt schrijven, gebruikt u VisualsToXpsDocument.
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(Visual, PrintTicket)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(FixedDocumentSequence, PrintTicket, Object)
Schrijft asynchroon een opgegeven FixedDocumentSequence samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- fixedDocumentSequence
- FixedDocumentSequence
De set documenten die moeten worden geschreven.
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor de set documenten vertegenwoordigt.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
WriteAsync schrijft een set documenten asynchroon naar of XpsDocumentPrintQueue die de XpsDocumentWriter. De gegevens die zijn geschreven, bevatten een PrintTicket en aanvullende informatie die de beller wil doorgeven aan een gebeurtenis-handler.
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode voegt u een FixedDocument of een set FixedDocument elementen toe aan de bestaande reeks.
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Van toepassing op
WriteAsync(FixedDocument, PrintTicket, Object)
Schrijft asynchroon een opgegeven FixedDocument samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- fixedDocument
- FixedDocument
Het document dat is geschreven.
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor het document vertegenwoordigt.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode wordt een FixedDocument aan de set toegevoegd.
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Van toepassing op
WriteAsync(FixedPage, PrintTicket, Object)
Schrijft asynchroon een opgegeven FixedPage samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- fixedPage
- FixedPage
De pagina die is geschreven.
- printTicket
- PrintTicket
Een PrintTicket die de standaardvoorkeuren voor afdrukken voor de pagina vertegenwoordigt.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Van toepassing op
WriteAsync(Visual, PrintTicket, Object)
Schrijft asynchroon een opgegeven Visual samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor het document vertegenwoordigt.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
Gebruik Visualvoor het schrijven van meerdere VisualsToXpsDocument elementen .
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Van toepassing op
WriteAsync(FixedDocumentSequence, PrintTicket)
Schrijft asynchroon een opgegeven FixedDocumentSequence samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- fixedDocumentSequence
- FixedDocumentSequence
De set documenten die zijn geschreven.
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor de set documenten vertegenwoordigt.
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode voegt u een FixedDocument of een set FixedDocument elementen toe aan de bestaande set.
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(FixedDocumentSequence, PrintTicket)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(DocumentPaginator, PrintTicket, Object)
Schrijft asynchrone gepagineerde inhoud van een opgegeven DocumentPaginator samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- documentPaginator
- DocumentPaginator
Een object dat een aanwijzer bevat naar niet-gepagineerd bronmateriaal; bevat ook methoden voor het pagineren van het materiaal.
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor het materiaal vertegenwoordigt.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Van toepassing op
WriteAsync(FixedDocumentSequence, Object)
Schrijft asynchroon een opgegeven FixedDocumentSequence naar het doel XpsDocument of 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)
Parameters
- fixedDocumentSequence
- FixedDocumentSequence
De set documenten die zijn geschreven.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode voegt u een FixedDocument of een set FixedDocument elementen toe aan de bestaande set.
Van toepassing op
WriteAsync(FixedDocumentSequence)
Schrijft asynchroon een opgegeven FixedDocumentSequence naar het doel XpsDocument of 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)
Parameters
- fixedDocumentSequence
- FixedDocumentSequence
De set documenten die zijn geschreven.
Voorbeelden
In het volgende voorbeeld ziet u hoe u deze methode gebruikt om naar een XPS-document te schrijven.
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
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode voegt u een FixedDocument of een set FixedDocument elementen toe aan de bestaande set.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(FixedDocumentSequence)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(FixedDocument, Object)
Schrijft asynchroon een opgegeven FixedDocument naar het doel XpsDocument of 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)
Parameters
- fixedDocument
- FixedDocument
Het document dat is geschreven.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode wordt een FixedDocument aan de set toegevoegd.
Van toepassing op
WriteAsync(DocumentPaginator, PrintTicket)
Schrijft asynchrone gepagineerde inhoud van een opgegeven DocumentPaginator samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- documentPaginator
- DocumentPaginator
Een object met een aanwijzer naar niet-gepagineerd bronmateriaal en bevat ook methoden voor het pagineren van het materiaal.
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor het materiaal vertegenwoordigt.
Opmerkingen
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(DocumentPaginator, PrintTicket)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(DocumentPaginator, Object)
Schrijft asynchrone gepagineerde inhoud van een opgegeven DocumentPaginator naar het doel XpsDocument of 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)
Parameters
- documentPaginator
- DocumentPaginator
Een object dat een aanwijzer bevat naar niet-gepagineerd bronmateriaal; bevat ook methoden voor het pagineren van het materiaal.
- userSuppliedState
- Object
Een door de gebruiker opgegeven object om de asynchrone bewerking te identificeren en te koppelen.
Van toepassing op
WriteAsync(String, XpsDocumentNotificationLevel)
Schrijft asynchroon een opgegeven XPS-document met meldingsoptie naar het doel XpsDocument of 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)
Parameters
- documentPath
- String
Het pad van het brondocument.
- notificationLevel
- XpsDocumentNotificationLevel
Een indicatie van of de melding is ingeschakeld.
Opmerkingen
Wanneer notificationLevel dit is uitgeschakeld, kopieert u XpsDocumentWriter het geserialiseerde XPS-document naar het doel XpsDocument of PrintQueue dat het XpsDocumentWriteris gemaakt. Wanneer notificationLevel dit is ingeschakeld, wordt het XpsDocumentWriter document eerst gedeserialiseerd en vervolgens opnieuw geserialiseerd en vervolgens naar het doel geschreven met voortgangsmeldingen wanneer elke pagina wordt uitgevoerd.
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode worden de FixedDocument elementen in de bron toegevoegd aan de reeks FixedDocument elementen in het doel XpsDocument of PrintQueue.
Als notificationLevel dit is opgegeven als ReceiveNotificationEnabled, worden meldingen alleen geproduceerd wanneer het document wordt geserialiseerd, niet afgedrukt. Als u meldingen wilt ontvangen, moet het document opnieuw worden geserialiseerd. Wanneer een document opnieuw wordt geserialiseerd, wordt alle inhoud van het Package document dat niet door de XML-papierspecificatie moet worden bewaard, verwijderd. Met de reserialisatie worden ook alle extensies uit de FixedPage markering verwijderd, inclusief uitgebreide XPS-inhoud.
Als notificationLevel het document wordt opgegeven als ReceiveNotificationDisabled het document niet opnieuw wordt geserialiseerd en uitgebreide inhoud behouden blijft, zelfs wanneer het wordt afgedrukt.
Met deze WriteAsync methode wordt de WritingPrintTicketRequired gebeurtenis niet aangeroepen.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(String, XpsDocumentNotificationLevel)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(Visual)
Schrijft asynchroon een opgegeven Visual naar het doel XpsDocument of 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)
Parameters
Voorbeelden
In het volgende voorbeeld ziet u hoe u deze methode gebruikt om een Visual XPS-document te schrijven.
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
Opmerkingen
Als u een Visualbatch wilt schrijven, gebruikt u VisualsToXpsDocument.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(Visual)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(FixedPage)
Schrijft asynchroon een opgegeven FixedPage naar het doel XpsDocument of 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)
Parameters
- fixedPage
- FixedPage
De pagina die is geschreven.
Opmerkingen
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(FixedPage)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(FixedDocument)
Schrijft asynchroon een opgegeven FixedDocument naar het doel XpsDocument of 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)
Parameters
- fixedDocument
- FixedDocument
Het document dat is geschreven.
Voorbeelden
In het volgende voorbeeld ziet u hoe u deze methode gebruikt om naar een XPS-document te schrijven.
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
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode wordt een FixedDocument aan de set toegevoegd.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(FixedDocument)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(DocumentPaginator)
Schrijft asynchrone gepagineerde inhoud van een opgegeven DocumentPaginator naar het doel XpsDocument of 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)
Parameters
- documentPaginator
- DocumentPaginator
Een object met een aanwijzer naar niet-gepagineerd bronmateriaal en bevat ook methoden voor het pagineren van het materiaal.
Voorbeelden
In het volgende voorbeeld ziet u hoe u deze methode gebruikt om naar een XPS-document te schrijven.
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
Opmerkingen
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(DocumentPaginator)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(String)
Schrijft asynchroon een opgegeven XPS-document naar het doel XpsDocument of PrintQueue.
public:
void WriteAsync(System::String ^ documentPath);
public void WriteAsync(string documentPath);
override this.WriteAsync : string -> unit
Public Sub WriteAsync (documentPath As String)
Parameters
- documentPath
- String
Het pad van het brondocument.
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode worden de FixedDocument elementen in de bron toegevoegd aan de set FixedDocument elementen in het doel XpsDocument of PrintQueue.
Met deze WriteAsync methode wordt het opgegeven XPS-document opnieuw hererialiseerd, waardoor alle inhoud wordt verwijderd uit het Package document dat niet hoeft te worden bewaard door de XML Paper-specificatie. Met de reserialisatie worden ook alle extensies uit de FixedPage markering verwijderd, inclusief uitgebreide XPS-inhoud.
Deze methode roept de WriteAsyncWritingPrintTicketRequired gebeurtenis standaard niet aan.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAsync(FixedDocument, PrintTicket)
Schrijft asynchroon een opgegeven FixedDocument samen met een PrintTicket naar het doel XpsDocument of 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)
Parameters
- fixedDocument
- FixedDocument
Het document dat is geschreven.
- printTicket
- PrintTicket
Een PrintTicket die de standaard afdrukvoorkeuren voor het document vertegenwoordigt.
Opmerkingen
Hoewel de XpsDocument klasse een enkelvoudige naam heeft, kan een XpsDocument of een set meerdere documenten zijn FixedDocument . Met deze methode wordt een FixedDocument aan de set toegevoegd.
Met deze methode wordt de opgegeven printTicket waarde voor een bepaalde PrintQueuemethode niet gevalideerd of gewijzigd. Gebruik indien nodig de MergeAndValidatePrintTicket methode om een PrintTicket specifieke printer te maken die specifiek is voor de PrintQueue printer.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(FixedDocument, PrintTicket)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.