XpsDocumentWriter.WriteAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrit de façon asynchrone dans le XpsDocument ou PrintQueue celui-ci a créé le XpsDocumentWriter.
Surcharges
WriteAsync(FixedPage, Object)
Écrit de façon asynchrone un spécifié FixedPage dans la cible XpsDocument ou 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)
Paramètres
- fixedPage
- FixedPage
Page écrite.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
S’applique à
WriteAsync(FixedPage, PrintTicket)
Écrit de manière asynchrone un spécifié FixedPage avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- fixedPage
- FixedPage
Page écrite.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour la page.
Remarques
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedPage, PrintTicket).
S’applique à
WriteAsync(Visual, Object)
Écrit de façon asynchrone un spécifié Visual dans la cible XpsDocument ou 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)
Paramètres
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
Pour écrire par lots un Visual, utilisez VisualsToXpsDocument.
S’applique à
WriteAsync(Visual, PrintTicket)
Écrit de manière asynchrone un spécifié Visual avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour le document.
Remarques
Pour écrire par lots un Visual, utilisez VisualsToXpsDocument.
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(Visual, PrintTicket).
S’applique à
WriteAsync(FixedDocumentSequence, PrintTicket, Object)
Écrit de manière asynchrone un spécifié FixedDocumentSequence avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- fixedDocumentSequence
- FixedDocumentSequence
Ensemble de documents à écrire.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour l’ensemble de documents.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
WriteAsync écrit un ensemble de documents de manière asynchrone dans le XpsDocument ou PrintQueue qui a créé le XpsDocumentWriter. Les données écrites incluent des PrintTicket informations supplémentaires que l’appelant souhaite transmettre à un gestionnaire d’événements.
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument ou un ensemble d’éléments FixedDocument à la séquence existante.
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
S’applique à
WriteAsync(FixedDocument, PrintTicket, Object)
Écrit de manière asynchrone un spécifié FixedDocument avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- fixedDocument
- FixedDocument
Document écrit.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour le document.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
S’applique à
WriteAsync(FixedPage, PrintTicket, Object)
Écrit de manière asynchrone un spécifié FixedPage avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- fixedPage
- FixedPage
Page écrite.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour la page.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
S’applique à
WriteAsync(Visual, PrintTicket, Object)
Écrit de manière asynchrone un spécifié Visual avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour le document.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
Pour écrire plusieurs Visual éléments, utilisez VisualsToXpsDocument.
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
S’applique à
WriteAsync(FixedDocumentSequence, PrintTicket)
Écrit de manière asynchrone un spécifié FixedDocumentSequence avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- fixedDocumentSequence
- FixedDocumentSequence
Ensemble de documents écrits.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour l’ensemble de documents.
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument ou un ensemble d’éléments FixedDocument au jeu existant.
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocumentSequence, PrintTicket).
S’applique à
WriteAsync(DocumentPaginator, PrintTicket, Object)
Écrit du contenu paginé de façon asynchrone à partir d’un contenu spécifié DocumentPaginator avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- documentPaginator
- DocumentPaginator
Objet qui contient un pointeur vers un matériau source nonpaginé ; contient également des méthodes pour paginer le matériau.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour le matériau.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
S’applique à
WriteAsync(FixedDocumentSequence, Object)
Écrit de façon asynchrone un spécifié FixedDocumentSequence dans la cible XpsDocument ou 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)
Paramètres
- fixedDocumentSequence
- FixedDocumentSequence
Ensemble de documents écrits.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument ou un ensemble d’éléments FixedDocument au jeu existant.
S’applique à
WriteAsync(FixedDocumentSequence)
Écrit de façon asynchrone un spécifié FixedDocumentSequence dans la cible XpsDocument ou 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)
Paramètres
- fixedDocumentSequence
- FixedDocumentSequence
Ensemble de documents écrits.
Exemples
L’exemple suivant montre comment utiliser cette méthode pour écrire dans un document 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
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument ou un ensemble d’éléments FixedDocument au jeu existant.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocumentSequence).
S’applique à
WriteAsync(FixedDocument, Object)
Écrit de façon asynchrone un spécifié FixedDocument dans la cible XpsDocument ou 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)
Paramètres
- fixedDocument
- FixedDocument
Document écrit.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.
S’applique à
WriteAsync(DocumentPaginator, PrintTicket)
Écrit du contenu paginé de façon asynchrone à partir d’un contenu spécifié DocumentPaginator avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- documentPaginator
- DocumentPaginator
Objet qui contient un pointeur vers un matériau source nonpaginé et contient également des méthodes pour paginer le matériau.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour le matériau.
Remarques
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(DocumentPaginator, PrintTicket).
S’applique à
WriteAsync(DocumentPaginator, Object)
Écrit du contenu paginé de manière asynchrone à partir d’un contenu spécifié DocumentPaginator dans la cible XpsDocument ou 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)
Paramètres
- documentPaginator
- DocumentPaginator
Objet qui contient un pointeur vers un matériau source nonpaginé ; contient également des méthodes pour paginer le matériau.
- userSuppliedState
- Object
Objet spécifié par l’utilisateur pour identifier et associer à l’opération asynchrone.
S’applique à
WriteAsync(String, XpsDocumentNotificationLevel)
Écrit de manière asynchrone un document XPS spécifié avec l’option de notification sur la cible XpsDocument ou 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)
Paramètres
- documentPath
- String
Chemin d’accès du document source.
- notificationLevel
- XpsDocumentNotificationLevel
Indication indiquant si la notification est activée.
Remarques
Lorsqu’il notificationLevel est désactivé, les XpsDocumentWriter copies du document XPS sérialisé vers la cible XpsDocument ou PrintQueue qui a créé le XpsDocumentWriter. Lorsqu’il notificationLevel est activé, le XpsDocumentWriter premier désérialise le document, le réérialise ensuite, puis l’écrit dans la cible avec des notifications de progression à mesure que chaque page est en sortie.
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute les FixedDocument éléments de la source à la séquence d’éléments FixedDocument dans la cible XpsDocument ou PrintQueue.
Si notificationLevel elle est spécifiée comme ReceiveNotificationEnabled, les notifications sont produites uniquement lorsque le document est sérialisé, pas imprimé. Pour recevoir des notifications, le document doit être resérialisé. Lorsqu’un document est resérialisé, tout le contenu du Package document qui n’est pas requis pour être conservé par la spécification de papier XML est supprimé. La resérialisation supprime également toutes les extensions du FixedPage balisage, y compris tout contenu XPS étendu.
S’il notificationLevel est spécifié comme ReceiveNotificationDisabled document ne sera pas resérialisé et tout contenu étendu sera conservé, même lors de l’impression.
Par conception, cette WriteAsync méthode n’appelle pas l’événement WritingPrintTicketRequired .
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(String, XpsDocumentNotificationLevel).
S’applique à
WriteAsync(Visual)
Écrit de façon asynchrone un spécifié Visual dans la cible XpsDocument ou 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)
Paramètres
Exemples
L’exemple suivant montre comment utiliser cette méthode pour écrire un Visual document 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
Remarques
Pour écrire par lots un Visual, utilisez VisualsToXpsDocument.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(Visual).
S’applique à
WriteAsync(FixedPage)
Écrit de façon asynchrone un spécifié FixedPage dans la cible XpsDocument ou 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)
Paramètres
- fixedPage
- FixedPage
Page écrite.
Remarques
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedPage).
S’applique à
WriteAsync(FixedDocument)
Écrit de façon asynchrone un spécifié FixedDocument dans la cible XpsDocument ou 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)
Paramètres
- fixedDocument
- FixedDocument
Document écrit.
Exemples
L’exemple suivant montre comment utiliser cette méthode pour écrire dans un document 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
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocument).
S’applique à
WriteAsync(DocumentPaginator)
Écrit du contenu paginé de manière asynchrone à partir d’un contenu spécifié DocumentPaginator dans la cible XpsDocument ou 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)
Paramètres
- documentPaginator
- DocumentPaginator
Objet qui contient un pointeur vers un matériau source nonpaginé et contient également des méthodes pour paginer le matériau.
Exemples
L’exemple suivant montre comment utiliser cette méthode pour écrire dans un document 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
Remarques
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(DocumentPaginator).
S’applique à
WriteAsync(String)
Écrit de façon asynchrone un document XPS spécifié dans la cible XpsDocument ou PrintQueue.
public:
void WriteAsync(System::String ^ documentPath);
public void WriteAsync(string documentPath);
override this.WriteAsync : string -> unit
Public Sub WriteAsync (documentPath As String)
Paramètres
- documentPath
- String
Chemin d’accès du document source.
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute les FixedDocument éléments de la source à l’ensemble d’éléments FixedDocument dans la cible XpsDocument ou PrintQueue.
Cette WriteAsync méthode resérialise le document XPS spécifié, qui supprime tout le contenu du Package document XML qui n’est pas requis pour être conservé par la spécification de papier XML. La resérialisation supprime également toutes les extensions du FixedPage balisage, y compris tout contenu XPS étendu.
Par conception, cette WriteAsync méthode n’appelle pas l’événement WritingPrintTicketRequired .
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(String).
S’applique à
WriteAsync(FixedDocument, PrintTicket)
Écrit de manière asynchrone un spécifié FixedDocument avec une PrintTicket cible XpsDocument ou 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)
Paramètres
- fixedDocument
- FixedDocument
Document écrit.
- printTicket
- PrintTicket
Qui PrintTicket représente les préférences d’impression par défaut pour le document.
Remarques
Bien que la XpsDocument classe ait un nom singulier, il XpsDocument peut s’agir d’un ou d’un FixedDocument ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.
Cette méthode ne valide pas ou ne modifie pas la valeur spécifiée printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket élément spécifique à celui-ci PrintQueue et est valide pour une imprimante spécifiée.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocument, PrintTicket).