How to: Create New Documents

When you create a document programmatically, the new document is a native Microsoft.Office.Interop.Word.Document object. This object does not have the additional events and data binding capabilities of a Microsoft.Office.Tools.Word.Document host item. For more information, see Programmatic Limitations of Host Items and Host Controls.

Applies to: The information in this topic applies to document-level projects and application-level projects for Word 2007 and Word 2010. For more information, see Features Available by Office Application and Project Type.

When you develop a document-level project, you cannot programmatically add Microsoft.Office.Tools.Word.Document host items to your project. In an application-level project, you can convert any Microsoft.Office.Interop.Word.Document object to a Microsoft.Office.Tools.Word.Document host item at run time. For more information, see Extending Word Documents and Excel Workbooks in Application-Level Add-ins at Run Time.

To create a new document based on the Normal template

  • Use the Add method of the Documents collection to create a new document based on the Normal template. To use this code example, run it from the ThisDocument or ThisAddIn class in your project.

    Me.Application.Documents.Add()
    
    this.Application.Documents.Add();
    

Using Custom Templates

The Add method has an optional Template argument to create a new document based on a template other than the Normal template. You must supply the file name and fully qualified path of the template.

To create a new document based on a custom template

  • Call the Add method of the Documents collection and specify the path to the template. To use this code example, run it from the ThisDocument or ThisAddIn class in your project.

    Me.Application.Documents.Add(Template:="C:\Test\SampleTemplate.Dot")
    
    this.Application.Documents.Add(@"C:\Test\SampleTemplate.dot");
    

See Also

Tasks

How to: Open Existing Documents

Concepts

Host Items and Host Controls Overview

Programmatic Limitations of Host Items and Host Controls

Optional Parameters in Office Solutions