Comment : enregistrer des documents par programmationHow to: Programmatically Save Documents

Il existe plusieurs façons d’enregistrer des documents Microsoft Office Word.There are several ways to save Microsoft Office Word documents. Vous pouvez enregistrer un document sans modifier le nom du document, ou vous pouvez enregistrer un document avec un nouveau nom.You can save a document without changing the name of the document, or you can save a document with a new name.

S’applique à : les informations contenues dans cette rubrique s’applique au document-projets et ajouter de VSTO de niveau-dans les projets pour Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Enregistrement d’un Document sans modifier le nomSaving a Document Without Changing the Name

Pour enregistrer le document associé à une personnalisation au niveau du documentTo save the document associated with a document-level customization

  1. Appelez la méthode Save de la classe Document.Call the Save method of the Document class. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisDocument de votre projet.To use this code example, run it from the ThisDocument class in your project.

    Me.Save()
    
    this.Save();
    

Pour enregistrer le document actifTo save the active document

  1. Appelez le Save méthode pour le document actif.Call the Save method for the active document. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisDocument ou ThisAddIn de votre projet.To use this code example, run it from the ThisDocument or ThisAddIn class in your project.

    Me.Application.ActiveDocument.Save()
    
    this.Application.ActiveDocument.Save();
    

    Si vous n’êtes pas sûr si le document que vous souhaitez enregistrer est le document actif, vous pouvez faire référence à ce dernier par son nom.If you are not sure whether the document you want to save is the active document, you can refer to it by its name.

Pour enregistrer un document spécifié par nomTo save a document specified by name

  1. Utilisez le nom du document comme argument à la Microsoft.Office.Interop.Word.Documents collection.Use the document name as an argument to the Microsoft.Office.Interop.Word.Documents collection. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisDocument ou ThisAddIn de votre projet.To use this code example, run it from the ThisDocument or ThisAddIn class in your project.

    Me.Application.Documents("C:\Test\NewDocument.docx").Save()
    
    this.Application.Documents[@"C:\Test\NewDocument.docx"].Save();
    

Enregistrement d’un Document avec un nouveau nomSaving a Document With a New Name

Utilisez la méthode SaveAs pour enregistrer un document avec un nouveau nom.Use the SaveAs method to save a document with a new name. Vous pouvez utiliser cette méthode pour le Document élément hôte dans un projet de Word au niveau du document ou de natif Document objet dans tous les projets Word.You can use this method of the Document host item in a document-level Word project, or of a native Document object in any Word project. Cette méthode requiert que vous spécifiez le nouveau nom de fichier, mais les autres arguments sont facultatifs.This method requires that you specify the new file name, but other arguments are optional.

Note

Si vous affichez la SaveAs boîte de dialogue à l’intérieur de la DocumentBeforeSave Gestionnaire d’événements de ThisDocument et définir le Annuler paramètre false, l’application peut fermer de façon inattendue.If you show the SaveAs dialog box inside of the DocumentBeforeSave event handler of ThisDocument and set the Cancel parameter to false, the application might quit unexpectedly. Si vous définissez la Annuler paramètre true, un message d’erreur apparaît indiquant que cette fonctionnalité a été désactivée.If you set the Cancel parameter to true, an error message appears indicating that Autosave has been disabled.

Pour enregistrer le document associé à une personnalisation au niveau du document sous un nouveau nomTo save the document associated with a document-level customization with a new name

  1. Appelez le SaveAs méthode de la ThisDocument classe dans votre projet, à l’aide d’un chemin d’accès et un nom qualifié complet.Call the SaveAs method of the ThisDocument class in your project, using a fully qualified path and file name. Si un fichier du même nom existe déjà dans ce dossier, il est automatiquement remplacé.If a file by that name already exists in that folder, it is silently overwritten. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisDocument .To use this code example, run it from the ThisDocument class.

    Note

    Le SaveAs méthode lève une exception si un répertoire cible n’existe pas ou s’il existe d’autres problèmes que l’enregistrement d’un fichier.The SaveAs method throws an exception if a target directory does not exist or if there are other problems saving a file. Il est conseillé d’utiliser un try... catch bloquer autour de la SaveAs méthode ou à l’intérieur d’une méthode d’appel.It is a good practice to use a try...catch block around the SaveAs method or inside a calling method.

    Me.SaveAs("C:\Test\NewDocument.docx")
    
    object fileName = @"C:\Test\NewDocument.docx"; 
    
    this.SaveAs(ref fileName,
        ref missing, ref missing, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing, ref missing, ref missing);
    

Pour enregistrer un document natif sous un nouveau nomTo save a native document with a new name

  1. Appelez le SaveAs méthode de le Document que vous souhaitez enregistrer, à l’aide d’un chemin d’accès et un nom qualifié complet.Call the SaveAs method of the Document that you want to save, using a fully qualified path and file name. Si un fichier du même nom existe déjà dans ce dossier, il est automatiquement remplacé.If a file by that name already exists in that folder, it is silently overwritten.

    L’exemple de code suivant enregistre le document actif avec un nouveau nom.The following code example saves the active document with a new name. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisDocument ou ThisAddIn de votre projet.To use this code example, run it from the ThisDocument or ThisAddIn class in your project.

    Note

    Le SaveAs méthode lève une exception si un répertoire cible n’existe pas ou s’il existe d’autres problèmes que l’enregistrement d’un fichier.The SaveAs method throws an exception if a target directory does not exist or if there are other problems saving a file. Il est conseillé d’utiliser un try... catch bloquer autour de la SaveAs méthode ou à l’intérieur d’une méthode d’appel.It is a good practice to use a try...catch block around the SaveAs method or inside a calling method.

    Me.Application.ActiveDocument.SaveAs("C:\Test\NewDocument.docx")
    
    object fileName = @"C:\Test\NewDocument.docx";
    
    this.Application.ActiveDocument.SaveAs(ref fileName,
        ref missing, ref missing, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing, ref missing, ref missing);
    

Compilation du codeCompiling the Code

Cet exemple de code doit respecter la condition suivante :This code example requires the following:

  • Pour enregistrer un document par son nom, un document nommé NouveauDocument.doc doit exister dans un répertoire nommé Test sur le lecteur C.To save a document by name, a document named NewDocument.doc must exist in a directory named Test on drive C.

  • Pour enregistrer un document avec un nouveau nom, un répertoire nommé Test doit exister sur le lecteur C.To save a document with a new name, a directory named Test must exist on drive C.

Voir aussiSee Also

Comment : fermer des Documents par programmation How to: Programmatically Close Documents
Comment : ouvrir des Documents existants par programmation How to: Programmatically Open Existing Documents
Élément hôte de document Document Host Item
Paramètres optionnels dans les solutions OfficeOptional Parameters in Office Solutions