Comment : référencer des documents dans la collection Documents

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Projets au niveau de l'application Version de Microsoft Office Word 2003 Word 2007 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous pouvez faire référence à un objet Microsoft.Office.Interop.Word.Document comme membre de la collection Documents en utilisant le nom du document ou sa valeur d'index dans la collection.

Si vous souhaitez travailler avec un document spécifique, la meilleure solution est d'utiliser son nom. Vous faites rarement référence à un document par le biais de sa valeur d'index dans la collection Documents car cette valeur peut changer pour un document donné lorsque d'autres documents sont ouverts et fermés.

Référence à des documents

Pour faire référence à un document par son nom

• Définissez une variable objet pour qu'elle pointe vers le document nommé SampleDoc.doc. Pour utiliser l'exemple suivant, exécutez le code à partir de la classe ThisDocument ou ThisAddIn dans votre projet.

  Dim doc As Word.Document = CType(Application.Documents("SampleDoc.doc"), Word.Document)
  

  object fileName = "SampleDoc.doc"; 
  Word.Document doc = Application.Documents.get_Item(ref fileName); 
  

Si vous souhaitez faire référence au document actif (document ayant le focus), vous pouvez utiliser la propriété ActiveDocument de l'objet Application.

Pour faire référence au document actif

• Récupérez le nom du document actif à l'aide de ActiveDocument. Pour utiliser l'exemple suivant, exécutez le code à partir de la classe ThisDocument ou ThisAddIn dans votre projet.

  Dim documentName As String = Application.ActiveDocument.Name
  

  string documentName = Application.ActiveDocument.Name;
  

Si vous travaillez uniquement avec le document associé à une personnalisation au niveau du document, vous pouvez utiliser la référence Globals.ThisDocument à partir de n'importe quel endroit du projet lorsque vous devez faire référence au document qui a le focus.

Pour référencer le document associé à une personnalisation au niveau du document

• Récupérez le nom du document à l'aide de Globals.ThisDocument.

  Dim documentName2 As String = Globals.ThisDocument.Name
  

  string documentName2 = Globals.ThisDocument.Name;
  

Voir aussi

Tâches

Comment : ouvrir des documents existants

Comment : insérer du texte dans les documents Word

Concepts

Accès global aux objets dans les projets Visual Studio Tools pour Office

Vue d'ensemble des éléments hôtes et des contrôles hôtes