_ExternalApplication.Open(String, Int32) Method

Definition

Namespace:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Opens the specified Microsoft InfoPath form.

public:
 void Open(System::String ^ bstrDocumentURI, int dwBehavior);

public void Open (string bstrDocumentURI, int dwBehavior);

abstract member Open : string * int -> unit

Public Sub Open (bstrDocumentURI As String, dwBehavior As Integer)

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 Open method of the ExternalApplication object is used to open a form from the file system:

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

 // Open an InfoPath form.

 infoPath.<span class="label">Open</span>(@"C:\My Forms\Form1.xml", 1);

 // Close the InfoPath form.
 infoPath.Close(@"C:\My Forms\Form1.xml");

 // Quit the InfoPath application.
 infoPath.Quit();
}

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 Open method of the ExternalApplication object is used to open a form from the file system:

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

 // Open an InfoPath form.

 infoPath.<span class="label">Open</span>(@"C:\My Forms\Form1.xml", 1);

 // Close the InfoPath form.
 infoPath.Close(@"C:\My Forms\Form1.xml");

 // Quit the InfoPath application.
 infoPath.Quit();
}

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 Open method can be used only to open a form; it cannot be used to open a form template. To create a form from a form template, use the NewFromSolution(String) method. To create a form based on an existing form, use the New(String, Int32) method.

Important: This member can be accessed only by forms opened from a form template that has been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.