Export (0) Print
Expand All

How to: Write Conditional Logic That Determines the Run-time Environment

Last modified: June 28, 2011

Applies to: InfoPath 2013 | InfoPath Forms Services | Office 2013 | SharePoint Server 2013

The Environment property of the Application class gets a reference to an Environment object, which can be used to determine which runtime environment (InfoPath, Web browser, or mobile browser) was used to open the form.

Determining Which Runtime Environment a Form is Running In

The Environment class provides the IsBrowser and IsMobile properties that enable you to determine what editing environment was used to open a form template. If both properties return false, the form template was opened in the Microsoft InfoPath editor. If either property returns true, the form template was opened from an appropriately configured document library on Microsoft SharePoint Server 2010 running InfoPath Forms Services in the program for the corresponding property: a Web browser (IsBrowser property) or a mobile browser (IsMobile property).

In the following example, if the form is opened in a browser or mobile browser, the value of field1 (which is bound to a Text Box control) is set to a string to indicate which runtime environment the form was opened in. If the form is opened in InfoPath, the System.Windows.Forms.MessageBox.Show method (which isn't available when a form is running in a browser) is used to display a message box.

Important note Important

When you create the form template for the following code sample, select the Blank template on the New tab of the Backstage view. (Alternatively, you can select Web Browser Form from the Form type drop-down list under the Compatibility category of the Form Options dialog box.) To support the MessageBox class, add a reference to System.Windows.Forms on the .NET tab of the Add Reference dialog box in Visual Studio 2012, and then add a using or Imports directive for System.Windows.Forms in the declarations section of the form code module.

If (Me.Application.Environment.IsBrowser) Then
   CreateNavigator().SelectSingleNode(_
      "/my:myFields/my:field1", NamespaceManager). _
      SetValue("Running in a browser.")
ElseIf (Me.Application.Environment.IsMobile) Then
   CreateNavigator().SelectSingleNode( _
      "/my:myFields/my:field1", NamespaceManager). _
      SetValue("Running in a mobile browser.")
Else
   MessageBox.Show("This form is running in the InfoPath editor.")
End If
Show:
© 2014 Microsoft