Enregistrement d'un document XPS, exemple
Mise à jour : novembre 2007
XpsSave illustre comment enregistrer un document XML Paper Specification (XPS) dans un fichier, de manière soit synchrone soit asynchrone. Une fois exécuté, l'exemple affiche une section « Sélectionner le contenu » ComboBox qui permet à l'utilisateur de choisir parmi cinq types de contenu prédéfinis : une ou plusieurs représentations visuelles, un document dynamique, un ou plusieurs documents fixes. Le contenu sélectionné s'affiche dans le contrôle DocumentViewer situé dans le volet droit de la fenêtre d'application. Une fois le contenu sélectionné, deux boutons sont automatiquement activés : « Enregistrer – Synchrone » et « Enregistrer – Asynchrone ». L'utilisation de ces boutons entraîne l'affichage d'une boîte de dialogue « Enregistrer sous » qui lance ensuite l'enregistrement du document XML Paper Specification (XPS) dans un fichier particulier.
« Enregistrer – Synchrone » présente les principales opérations du processus d'enregistrement d'un document XPS. Lors d'enregistrement synchrone, l'interface utilisateur est en attente de la fin du processus. Ce temps d'attente de la fin de l'enregistrement peut être satisfaisant dans le cas de documents non volumineux dont le traitement est rapide, mais n'est pas recommandée pour les documents volumineux dont le traitement est nettement plus long.
« Enregistrer – Asynchrone » permet à l'interface utilisateur d'être toujours opérationnelle pendant l'enregistrement XPS s'exécute de façon indépendante. L'enregistrement asynchrone requiert une légère définition de code supplémentaire, mais il s'agit de la « meilleure pratique » recommandée pour assurer la réactivité de l'interface utilisateur.
Cet exemple présente une fonctionnalité spécifique de Windows Presentation Foundation (WPF) et, par conséquent, ne suit pas les meilleures pratiques de développement d'applications. Pour un traitement complet des meilleures pratiques de développement d'applications Windows Presentation Foundation (WPF) et Microsoft .NET Framework, reportez-vous, selon les cas, aux documents suivants :
Accessibilité - Meilleures pratiques d'accessibilité
Sécurité - Sécurité de Windows Presentation Foundation
Localisation - Vue d'ensemble de la globalisation et de la localisation WPF
Génération de l'exemple
Installez le Kit de développement logiciel (SDK) Windows et ouvrez la fenêtre Commande de son environnement de génération. Dans le menu Démarrer, pointez sur Tous les programmes et sur Microsoft Windows SDK, puis cliquez sur CMD Shell.
Téléchargez l'exemple, généralement à partir de la documentation du Kit de développement logiciel (SDK), vers votre disque dur local.
Pour générer l'exemple à partir de la fenêtre Commande de l'environnement de génération, accédez au répertoire source de l'exemple. À l'invite de commandes, tapez MSBUILD.
Pour générer l'exemple dans Microsoft Visual Studio, chargez l'exemple de solution ou de fichier projet, puis appuyez sur CTRL+MAJ+B.
Exécution de l'exemple
Pour exécuter l'exemple compilé avec le débogage dans Visual Studio, appuyez sur F5.
Pour exécuter l'exemple à partir d'une fenêtre de Commande de CMD Shell, exécutez le fichier .exe contenu dans le dossier source de l'exemple.
Voir aussi
Tâches
Création d'un document XPS, exemple
Lire, écrire et signer un document XPS, exemple
Écriture dans un package, exemple