_ExternalApplication.New(String, Int32) Method

Definition

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Creates a new Microsoft InfoPath form based on a specified form.

public void New (string bstrDocumentURI, int dwBehavior = 1);

abstract member New : string * int -> unit

Public Sub New (bstrDocumentURI As String, Optional dwBehavior As Integer = 1)

Parameters

bstrDocumentURI

String

The string value that specifies the Uniform Resource Identifier (URI) of a form.

dwBehavior

Int32

Default value is 1. Specifies how the form should be opened. The values are based on the XdDocumentVersionMode enumeration.

Examples

In the following example, which is written in the C# programming language, the New method of the ExternalApplication object is used to create a new form based on a specified form:

private void CreateFromForm()
{
 ExternalApplication infoPath = new ExternalApplicationClass();

 // Create an InfoPath form.
 infoPath.<span class="label">New</span>(@"C:\My Forms\Form1.xml", 1);
}

Note: The above example assumes that the Microsoft.Office.Interop.InfoPath namespace is being used and that the Microsoft InfoPath 3.0 Type Library is referenced.

In the following example, which is written in the C# programming language, the New method of the ExternalApplication object is used to create a new form based on a specified form:

private void CreateFromForm()
{
 ExternalApplication infoPath = new ExternalApplicationClass();

 // Create an InfoPath form.
 infoPath.<span class="label">New</span>(@"C:\My Forms\Form1.xml", 1);
}

Note: The above example assumes that the Microsoft.Office.Interop.InfoPath namespace is being used and that the Microsoft InfoPath 3.0 Type Library is referenced.

Remarks

The New method can be used to only create a new form based on an existing form; it cannot be used to create a new form based on a form template. To create a form from a form template, use the NewFromSolution(String) method.

When you use the New method, InfoPath is opened and the new form is ready to be filled out.

Note   You cannot use Close(String) to close a form that has been opened with the New method. When the New method creates a form, the name of that form is not yet known.