AddBookmark(MapView,String,String) Method

Creates a new bookmark using the current location and time of the map view. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public Bookmark AddBookmark( 
   MapView mapView,
   string name,
   string description
)

Public Overloads Function AddBookmark( _
   ByVal mapView As MapView, _
   ByVal name As String, _
   ByVal description As String _
) As Bookmark

Parameters

mapView: The map view used to create the bookmark.
name: The name of the new bookmark.
description: The description of the new bookmark.

Return Value

The new bookmark added to the map.

Exceptions

Exception	Description
System.ArgumentException	The MapView must contain this Map and the name of the Bookmark must be unique for the Map.
System.ArgumentNullException	The MapView cannot be null.
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Example

Create a new bookmark from the active map view.

public Task<Bookmark> AddBookmarkAsync(string name)
{
  return QueuedTask.Run(() =>
  {
    //Get the active map view.
    var mapView = MapView.Active;
    if (mapView == null)
      return null;

    //Adding a new bookmark using the active view.
    return mapView.Map.AddBookmark(mapView, name);
  });
}

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

Map Class
Map Members
Overload List