OpenTaskAsync(String) Method

Opens an ArcGIS Pro .esriTasks file. The file is added to the current project and loaded into the Tasks pane.

Syntax

C#
Visual Basic (Declaration)

public static Task<Guid> OpenTaskAsync( 
   string taskFile
)

Public Overloads Shared Function OpenTaskAsync( _
   ByVal taskFile As String _
) As Task(Of Guid)

Parameters

taskFile: Full path to an .esriTasks file.

Return Value

A Task returning the unique identifier of the task file opened. Use this unique identifier as parameters to other API calls such as CloseTaskAsync or ExportTaskAsync.

Exceptions

Exception	Description
OpenTaskException	Error opening the task file. For example the taskFile is invalid or the Tasks pane is in Designer mode and editing another task item.
System.InvalidOperationException	This must be called on the UI thread.

Remarks

If the Tasks pane is not already visible, it will be opened. If the Tasks pane is visible, any current task item will be unloaded to allow the new item to be loaded.

If the Tasks pane is in Designer mode; then an OpenTaskException will be thrown. Task files can only be opened if the Tasks pane is not in Designer mode.

Example

// Open a task file
try
{
  // TODO - substitute your own .esriTasks file to be opened
  string taskFile = @"c:\Tasks\Get Started.esriTasks";
  System.Guid guid = await TaskAssistantModule.OpenTaskAsync(taskFile);

  // TODO - retain the guid returned for use with CloseTaskAsync
}
catch (OpenTaskException e)
{
  // exception thrown if task file doesn't exist or has incorrect format
  ArcGIS.Desktop.Framework.Dialogs.MessageBox.Show(e.Message);
}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

TaskAssistantModule Class
TaskAssistantModule Members
Overload List