XpsDocumentWriter.WriteAsync Méthode

Définition

Espace de noms:

System.Windows.Xps

Assembly:

System.Printing.dll

Écrit de façon asynchrone dans le XpsDocument ou PrintQueue à l’origine du XpsDocumentWriter.

Surcharges

WriteAsync(FixedPage, Object)	Écrit de façon asynchrone un FixedPage spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(FixedPage, PrintTicket)	Écrit de façon asynchrone un FixedPage spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.
WriteAsync(Visual, Object)	Écrit de façon asynchrone un Visual spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(Visual, PrintTicket)	Écrit de façon asynchrone un Visual spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.
WriteAsync(FixedDocumentSequence, PrintTicket, Object)	Écrit de façon asynchrone un FixedDocumentSequence spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.
WriteAsync(FixedDocument, PrintTicket, Object)	Écrit de façon asynchrone un FixedDocument spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.
WriteAsync(FixedPage, PrintTicket, Object)	Écrit de façon asynchrone un FixedPage spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.
WriteAsync(Visual, PrintTicket, Object)	Écrit de façon asynchrone un Visual spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.
WriteAsync(FixedDocumentSequence, PrintTicket)	Écrit de façon asynchrone un FixedDocumentSequence spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.
WriteAsync(DocumentPaginator, PrintTicket, Object)	Écrit le contenu paginé de façon asynchrone à partir d’un DocumentPaginator spécifié avec un PrintTicket dans le XpsDocument ou PrintQueue cible.
WriteAsync(FixedDocumentSequence, Object)	Écrit de façon asynchrone un FixedDocumentSequence spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(FixedDocumentSequence)	Écrit de façon asynchrone un FixedDocumentSequence spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(FixedDocument, Object)	Écrit de façon asynchrone un FixedDocument spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(DocumentPaginator, PrintTicket)	Écrit le contenu paginé de façon asynchrone à partir d’un DocumentPaginator spécifié avec un PrintTicket dans le XpsDocument ou PrintQueue cible.
WriteAsync(DocumentPaginator, Object)	Écrit de façon asynchrone le contenu paginé d’un DocumentPaginator spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(String, XpsDocumentNotificationLevel)	Écrit de façon asynchrone un document XPS spécifié avec l’option de notification dans la cible XpsDocument ou PrintQueue.
WriteAsync(Visual)	Écrit de façon asynchrone un Visual spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(FixedPage)	Écrit de façon asynchrone un FixedPage spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(FixedDocument)	Écrit de façon asynchrone un FixedDocument spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(DocumentPaginator)	Écrit de façon asynchrone le contenu paginé d’un DocumentPaginator spécifié dans le XpsDocument ou PrintQueue cible.
WriteAsync(String)	Écrit de façon asynchrone un document XPS spécifié dans la cible XpsDocument ou PrintQueue.
WriteAsync(FixedDocument, PrintTicket)	Écrit de façon asynchrone un FixedDocument spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

WriteAsync(FixedPage, Object)

Écrit de façon asynchrone un FixedPage spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, object userSuppliedState);

Paramètres

fixedPage

FixedPage

Page qui est écrite.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

WriteAsync(FixedPage, PrintTicket)

Écrit de façon asynchrone un FixedPage spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket);

Paramètres

fixedPage

FixedPage

Page qui est écrite.

printTicket

PrintTicket

PrintTicket qui 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 le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedPage, PrintTicket).

WriteAsync(Visual, Object)

Écrit de façon asynchrone un Visual spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Media.Visual visual, object userSuppliedState);

Paramètres

visual

Visual

Le Visual qui est écrit.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

Remarques

Pour écrire un lot, Visualutilisez VisualsToXpsDocument.

WriteAsync(Visual, PrintTicket)

Écrit de façon asynchrone un Visual spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket);

Paramètres

visual

Visual

Le Visual qui est écrit.

printTicket

PrintTicket

PrintTicket qui représente les préférences d’impression par défaut pour le document.

Remarques

Pour écrire un lot, Visualutilisez VisualsToXpsDocument.

Cette méthode ne valide pas ou ne modifie pas le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(Visual, PrintTicket).

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Écrit de façon asynchrone un FixedDocumentSequence spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket, object userSuppliedState);

Paramètres

fixedDocumentSequence

FixedDocumentSequence

Ensemble de documents à écrire.

printTicket

PrintTicket

PrintTicket qui représente les préférences d’impression par défaut pour l’ensemble de documents.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

Remarques

WriteAsync écrit un ensemble de documents de façon asynchrone dans ou XpsDocumentPrintQueue qui a créé le XpsDocumentWriter. Les données écrites incluent un et des PrintTicket informations supplémentaires que l’appelant souhaite transmettre à un gestionnaire d’événements.

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un 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 le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

WriteAsync(FixedDocument, PrintTicket, Object)

Écrit de façon asynchrone un FixedDocument spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket, object userSuppliedState);

Paramètres

fixedDocument

FixedDocument

Document qui est écrit.

printTicket

PrintTicket

PrintTicket qui représente les préférences d’impression par défaut pour le document.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

Remarques

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.

Cette méthode ne valide pas ou ne modifie pas le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

WriteAsync(FixedPage, PrintTicket, Object)

Écrit de façon asynchrone un FixedPage spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket, object userSuppliedState);

Paramètres

fixedPage

FixedPage

Page qui est écrite.

printTicket

PrintTicket

PrintTicket qui représente les préférences d’impression par défaut pour la page.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

Remarques

Cette méthode ne valide pas ou ne modifie pas le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

WriteAsync(Visual, PrintTicket, Object)

Écrit de façon asynchrone un Visual spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket, object userSuppliedState);

Paramètres

visual

Visual

Le Visual qui est écrit.

printTicket

PrintTicket

PrintTicket qui représente les préférences d’impression par défaut pour le document.

userSuppliedState

Object

Objet spécifié par l’utilisateur à 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 le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

WriteAsync(FixedDocumentSequence, PrintTicket)

Écrit de façon asynchrone un FixedDocumentSequence spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket);

Paramètres

fixedDocumentSequence

FixedDocumentSequence

Ensemble des documents qui sont écrits.

printTicket

PrintTicket

PrintTicket qui 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, un XpsDocument peut être un FixedDocument ou un 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 le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocumentSequence, PrintTicket).

WriteAsync(DocumentPaginator, PrintTicket, Object)

Écrit le contenu paginé de façon asynchrone à partir d’un DocumentPaginator spécifié avec un PrintTicket dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket, object userSuppliedState);

Paramètres

documentPaginator

DocumentPaginator

Objet qui contient un pointeur vers un matériau source non paginé et qui contient aussi des méthodes pour le paginer.

printTicket

PrintTicket

PrintTicket qui représente les préférences d’impression par défaut pour le matériau.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

Remarques

Cette méthode ne valide pas ou ne modifie pas le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

WriteAsync(FixedDocumentSequence, Object)

Écrit de façon asynchrone un FixedDocumentSequence spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, object userSuppliedState);

Paramètres

fixedDocumentSequence

FixedDocumentSequence

Ensemble des documents qui sont écrits.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

Remarques

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument ou un ensemble d’éléments FixedDocument au jeu existant.

WriteAsync(FixedDocumentSequence)

Écrit de façon asynchrone un FixedDocumentSequence spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence);

Paramètres

fixedDocumentSequence

FixedDocumentSequence

Ensemble des documents écrits.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour écrire dans un document XPS.

C#

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);
}

Remarques

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un 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 de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocumentSequence).

WriteAsync(FixedDocument, Object)

Écrit de façon asynchrone un FixedDocument spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, object userSuppliedState);

Paramètres

fixedDocument

FixedDocument

Document qui est écrit.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

Remarques

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.

WriteAsync(DocumentPaginator, PrintTicket)

Écrit le contenu paginé de façon asynchrone à partir d’un DocumentPaginator spécifié avec un PrintTicket dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket);

Paramètres

documentPaginator

DocumentPaginator

Objet qui contient un pointeur vers le document source non paginé, ainsi que les méthodes pour le paginer.

printTicket

PrintTicket

PrintTicket qui 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 le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(DocumentPaginator, PrintTicket).

WriteAsync(DocumentPaginator, Object)

Écrit de façon asynchrone le contenu paginé d’un DocumentPaginator spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, object userSuppliedState);

Paramètres

documentPaginator

DocumentPaginator

Objet qui contient un pointeur vers un matériau source non paginé et qui contient aussi des méthodes pour le paginer.

userSuppliedState

Object

Objet spécifié par l’utilisateur à identifier et à associer à l’opération asynchrone.

WriteAsync(String, XpsDocumentNotificationLevel)

Écrit de façon asynchrone un document XPS spécifié avec l’option de notification dans la cible XpsDocument ou PrintQueue.

C#

public void WriteAsync (string documentPath, System.Windows.Xps.XpsDocumentNotificationLevel notificationLevel);

Paramètres

documentPath

String

Chemin du document source.

notificationLevel

XpsDocumentNotificationLevel

Valeur indiquant si la notification est activée.

Remarques

Quand notificationLevel est désactivé, le XpsDocumentWriter copie le document XPS sérialisé vers la cible XpsDocument ou PrintQueue qui a créé le XpsDocumentWriter. Quand 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 sortie.

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un 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 est spécifié comme ReceiveNotificationEnabled, les notifications sont produites uniquement lorsque le document est sérialisé, et non imprimé. Pour recevoir des notifications, le document doit être réérialisé. Lorsqu’un document est resérialisé, tout le Package contenu du qui n’est pas requis pour être conservé par la spécification de papier XML est supprimé. La réérialisation supprime également toutes les extensions du FixedPage balisage, y compris tout contenu XPS étendu.

Si notificationLevel est spécifié, ReceiveNotificationDisabled le 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 de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(String, XpsDocumentNotificationLevel).

WriteAsync(Visual)

Écrit de façon asynchrone un Visual spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Media.Visual visual);

Paramètres

visual

Visual

Le Visual qui est écrit.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour écrire un Visual dans un document XPS.

C#

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

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

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

Remarques

Pour écrire un lot, Visualutilisez VisualsToXpsDocument.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(Visual).

WriteAsync(FixedPage)

Écrit de façon asynchrone un FixedPage spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage);

Paramètres

fixedPage

FixedPage

Page qui est écrite.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedPage).

WriteAsync(FixedDocument)

Écrit de façon asynchrone un FixedDocument spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument);

Paramètres

fixedDocument

FixedDocument

Document qui est écrit.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour écrire dans un document XPS.

C#

private void SaveSingleFixedContentDocumentAsync(
             XpsDocumentWriter xpsdw, FixedDocument fd)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the FixedDocument as a document.
    xpsdw.WriteAsync(fd);
}

Remarques

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocument).

WriteAsync(DocumentPaginator)

Écrit de façon asynchrone le contenu paginé d’un DocumentPaginator spécifié dans le XpsDocument ou PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator);

Paramètres

documentPaginator

DocumentPaginator

Objet qui contient un pointeur vers le document source non paginé, ainsi que les méthodes pour le paginer.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour écrire dans un document XPS.

C#

private void SaveSingleFlowContentDocumentAsync(
             XpsDocumentWriter xpsdw, DocumentPaginator idp)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the IDP as a document.
    xpsdw.WriteAsync(idp);
}

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(DocumentPaginator).

WriteAsync(String)

Écrit de façon asynchrone un document XPS spécifié dans la cible XpsDocument ou PrintQueue.

C#

public void WriteAsync (string documentPath);

Paramètres

documentPath

String

Chemin du document source.

Remarques

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un ensemble de plusieurs documents. Cette méthode ajoute les FixedDocument éléments de la source au jeu d’éléments FixedDocument dans la cible XpsDocument ou PrintQueue.

Cette WriteAsync méthode resérialise le document XPS spécifié, ce qui supprime tout le Package contenu du qui n’a pas besoin d’être conservé par la spécification de papier XML. La réé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 de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(String).

WriteAsync(FixedDocument, PrintTicket)

Écrit de façon asynchrone un FixedDocument spécifié avec un PrintTicket dans le XpsDocument ou le PrintQueue cible.

C#

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket);

Paramètres

fixedDocument

FixedDocument

Document qui est écrit.

printTicket

PrintTicket

PrintTicket qui représente les préférences d’impression par défaut pour le document.

Remarques

Bien que la XpsDocument classe ait un nom singulier, un XpsDocument peut être un FixedDocument ou un ensemble de plusieurs documents. Cette méthode ajoute un FixedDocument à l’ensemble.

Cette méthode ne valide pas ou ne modifie pas le spécifié printTicket pour un particulier PrintQueue. Si nécessaire, utilisez la MergeAndValidatePrintTicket méthode pour créer un PrintTicket qui est spécifique à et PrintQueue est valide pour une imprimante spécifiée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(FixedDocument, PrintTicket).