Méthode DoCmd.OutputTo (Access)

  • Article

La méthode OutputTo exécute l’action OutputTo dans Visual Basic.

Syntaxe

expression.OutputTo (ObjectType, ObjectName, OutputFormat, OutputFile, AutoStart, TemplateFile, Encoding, OutputQuality)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom Requis/Facultatif Type de données Description
ObjectType Obligatoire AcOutputObjectType Constante AcOutputObjectType spécifiant le type de l'objet en sortie.
ObjectName Facultatif Variant Expression chaîne qui est le nom valide d'un objet du type sélectionné par l'argument ObjectType. Si vous souhaitez copier l’objet actif, spécifiez son type pour l’argument ObjectType, mais ne renseignez pas l’argument. Si vous exécutez le code Visual Basic contenant la méthode OutputTo dans une base de données bibliothèque, Microsoft Office Access recherche l'objet sous ce nom, d'abord dans la base de données bibliothèque, puis dans la base de données active.
OutputFormat Facultatif AcFormat Constante AcFormat indiquant le format de sortie. Si vous oubliez cet argument, Access vous demande le format de sortie.
OutputFile Facultatif Variant Expression chaîne qui représente le nom complet, y compris le chemin, du fichier dans lequel vous voulez copier l'objet. Si vous laissez cet argument vierge, Microsoft Access vous invite à fournir un nom de fichier de copie.
AutoStart Facultatif Variant Utilisez True (1) pour démarrer immédiatement l'application Microsoft Windows appropriée, avec le fichier indiqué par l'argument OutputFile chargé. Utilisez False (0) si vous ne voulez pas démarrer l'application. Cet argument est ignoré pour les fichiers Microsoft Internet Information Server (.htx, .idc) et Microsoft ActiveX Server (*.asp). Si vous laissez cet argument vide, la valeur par défaut (False) est utilisée.
TemplateFile Facultatif Variant Une expression chaîne qui correspond au nom complet, y compris le chemin d'accès, du fichier que vous voulez utiliser comme modèle pour un fichier HTML, HTX ou ASP.
Encoding Facultatif Variant Type de format de chiffrement des caractères voulu pour le texte ou les données HTML en sortie. Vous pouvez sélectionner MS-DOS, Unicode ou Unicode (UTF-8). Le paramétrage de l’argument MS-DOS n’est disponible que pour les fichiers texte. Si vous ne renseignez pas cet argument, Access effectue la copie des données à l’aide du codage Windows par défaut pour les fichiers texte et du codage système par défaut pour les fichiers HTML.
OutputQuality Facultatif AcExportQuality Une constante AcExportQuality qui spécifie le type de dispositif de sortie pour l'optimisation. La valeur par défaut est acExportQualityPrint.

Remarques

Faites appel à la méthode OutputTo pour sortir les données dans l’objet de la base de données Microsoft Access spécifié (une feuille de données, un formulaire, un rapport, un module, une page d’accès aux données) dans des formats de sortie différents.

Les modules ne peuvent être envoyés qu'au format Texte MS-DOS. Dès lors, si vous spécifiez acOutputModule pour l'argument ObjectType, vous devez spécifier acFormatTXT pour l'argument OutputFormat. Les formats Microsoft Internet Information Server et Microsoft ActiveX Server ne sont disponibles que pour les tables, les requêtes et les formulaires. Aussi, si vous spécifiez acFormatIIS ou acFormatASP pour l'argument OutputFormat, vous devez spécifier acOutputTable, acOutputQuery ou acOutputForm pour l'argument ObjectType.

Les données Access sont enregistrées dans le format sélectionné et peuvent être lues par une application qui utilise aussi ce format. Par exemple, vous pouvez enregistrer un rapport Access avec sa mise en forme dans un document .rtf et ouvrir ce document dans Microsoft Word.

Remarque

Vous pouvez enregistrer un fichier au format PDF ou XPS à partir d’un programme Microsoft Office 2007 uniquement après avoir installé un complément. Pour plus d’informations, voir Complément Microsoft Office 2007 : enregistrement au format PDF ou XPS.

Exemple

L’exemple de code suivant copie la table Employees au format RTF dans un fichier Employee.rtf et ouvre immédiatement ce fichier dans Microsoft Word pour Windows.

DoCmd.OutputTo acOutputTable, "Employees", _ 
 acFormatRTF, "Employee.rtf", True

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.