Partager via


XpsDocumentWriter.WriteAsync Méthode

Définition

É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.

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 qui est écrite.

userSuppliedState
Object

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

S’applique à

WriteAsync(FixedPage, PrintTicket)

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

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 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).

S’applique à

WriteAsync(Visual, Object)

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

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

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.

S’applique à

WriteAsync(Visual, PrintTicket)

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

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

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).

S’applique à

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

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

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

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.

S’applique à

WriteAsync(FixedDocument, PrintTicket, Object)

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

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 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.

S’applique à

WriteAsync(FixedPage, PrintTicket, Object)

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

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 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.

S’applique à

WriteAsync(Visual, PrintTicket, Object)

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

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

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.

S’applique à

WriteAsync(FixedDocumentSequence, PrintTicket)

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

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 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).

S’applique à

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.

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 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.

S’applique à

WriteAsync(FixedDocumentSequence, Object)

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

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 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.

S’applique à

WriteAsync(FixedDocumentSequence)

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

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 des 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, 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).

S’applique à

WriteAsync(FixedDocument, Object)

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

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 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.

S’applique à

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.

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 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).

S’applique à

WriteAsync(DocumentPaginator, Object)

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

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 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.

S’applique à

WriteAsync(String, XpsDocumentNotificationLevel)

Écrit de façon asynchrone un document XPS spécifié avec l’option de notification dans 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 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).

S’applique à

WriteAsync(Visual)

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

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

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.

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 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).

S’applique à

WriteAsync(FixedPage)

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

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 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).

S’applique à

WriteAsync(FixedDocument)

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

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 qui est é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, 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).

S’applique à

WriteAsync(DocumentPaginator)

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

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 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.

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 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).

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 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).

S’applique à

WriteAsync(FixedDocument, PrintTicket)

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

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 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).

S’applique à