/*=====================================================================
         * ===== INavigationAware implementation.
         * ====================================================================*/

        /// <summary>
        /// Captures configuration context from invoker, providing an updater
        /// for use when data capture is requested by the host.
        /// </summary>
        /// <param name="navigationContext"></param>
        public void OnNavigatedTo(NavigationContext navigationContext)
        {
            ModelSubForm <Location> sub = RetrieveSubForm(navigationContext);

            if (null != sub)
            {
                Location    = sub.Instance;
                sub.Updater = _updateCmd;
            }
        }
        /// <summary>
        /// Signals to re-use existing form. Assumes the invoker is unchanged.
        /// </summary>
        /// <param name="navigationContext"></param>
        public bool IsNavigationTarget(NavigationContext navigationContext)
        {
            ModelSubForm <Location> sub = RetrieveSubForm(navigationContext);

            // Is this a Location request?
            if (null == sub)
            {
                return(false);
            }
            // First entry to form?
            if (null == _location)
            {
                return(false);
            }

            Location = sub.Instance;
            return(true);
        }