Share via


XDocuments2.New method (Object, Int32)

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

Namespace:  Microsoft.Office.Interop.InfoPath
Assembly:  Microsoft.Office.Interop.InfoPath (in Microsoft.Office.Interop.InfoPath.dll)

Syntax

'Declaration
Function New ( _
    varURI As Object, _
    dwBehavior As Integer _
) As XDocument
'Usage
Dim instance As XDocuments2
Dim varURI As Object
Dim dwBehavior As Integer
Dim returnValue As XDocument

returnValue = instance.New(varURI, dwBehavior)
XDocument New(
    Object varURI,
    int dwBehavior
)

Parameters

  • varURI
    Type: System.Object

    Specifies the Uniform Resource Identifier (URI) of a form.

  • dwBehavior
    Type: System.Int32

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

Return value

Type: Microsoft.Office.Interop.InfoPath.XDocument
An _XDocument object.

Implements

XDocuments.New(Object, Int32)

Remarks

The New method can only be used to 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 method.

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

Examples

In the following example, the New method of the XDocumentsCollection collection is passed the URI of an existing form, and a new form is created and its associated _XDocument object returned:

XDocument newDocument;
newDocument = thisApplication.XDocuments.New(@"C:\MyForm.xml", 1);

See also

Reference

XDocuments2 interface

XDocuments2 members

New overload

Microsoft.Office.Interop.InfoPath namespace