/// <summary>
        /// Call this overload to display location suggestions as POST links. The LocationChosen event handler
        /// is called when a location is chosen.
        /// </summary>
        public void DisplaySuggestions(IList <NamedLocation> suggestions)
        {
            if (LocationChosen == null)
            {
                throw new ApplicationException("You must attach an event handler to the LocationChosen event before"
                                               + " calling this overload of DisplaySuggestions().");
            }

            SetSuggestions(suggestions);

            // Store in a hidden field so they can be reloaded on postback.
            hidSuggestionIds.Value = IdUtil.GetIdList <NamedLocation, int>(",", suggestions);
        }