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 à l’origine du XpsDocumentWriter.
Surcharges
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
- 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
- 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
- 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
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).