TaskManager control

In this topic

About the TaskManager control

Use the TaskManager control to organize tasks in a Web application. The TaskManager control generates hierarchical Extensible Markup Language (XML) data that can be used by an ASP.NET Navigation control, such as a Menu or TreeView. At runtime, nodes in the ASP.NET Menu or TreeView can be used to show the floating panel for a task (only visible at design-time).

Using the control

  1. To add controls to the page, open or create a Web site in Visual Studio. Open a Web form in design mode, select the Toolbox panel, and expand the ArcGIS Web Controls tab. Drag and drop a TaskManager control on the Web form. See the following screen shot that shows the control in Visual Studio:


  2. Expand the Navigation tab on the Toolbox panel to add an ASP.NET Navigation control. ASP.NET Navigation controls are provided to traverse content in a Web application. Use SiteMapPath to navigate pages in an application. The Menu and TreeView controls can bind to hierarchical XML data to initiate actions, such as showing a dialog box or navigating to another page. The TaskManager control generates hierarchical XML data at runtime, which can be used by both controls (this topic uses a Menu control). See the following screen shot that shows the Navigation tab expanded on the Toolbox panel: 


  3. At runtime, the XML data generated by the TaskManager needs to bind to the Navigation control. Set the BuddyControl property on the TaskManager. See the following screen shot that shows the BuddyControl on the TaskManager control:


  4. To add one or more task controls to the TaskManager, on the Toolbox panel select, then drag and drop any out-of-the-box or custom task controls on the TaskManager. Set the visibility of the task to false (so it does not show when the page first loads) and type a string in the Title property to define a menu item title for the task on the menu. The task shows at runtime when the title is clicked in the menu. There should be other controls on the page to work with, such as a Map control and TaskResults control. Proceed with setting up the task control to work with other controls. See the following screen shots showing controls on the TaskManager and setting visibility to false:


  5. To use the menu item at runtime to show a task, click the menu item created in Step 4 to show the task's dialog box on the Web page; the task is ready to use. See the following screen shot showing the menu item:

Members

The following table shows a list of properties related to the TaskManager control. For more reference information, see the TaskManager control in the library reference section.
Property name
Type
Description
BuddyControl
string
ID of the control that shows the list of tasks on the page.
NavigationPathSeparator
char
Separator between items in the path for values in the NavigationPath for tasks. The default is a forward slash (/).


See Also:

Web ADF controls
Customizing the Web Mapping application



To use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):
  • ESRI.ArcGIS.ADF.Web.UI.WebControls.dll