Шаблон Visual Studio

Установка шаблона Visual Studio для ArcGIS Viewer for Silverlight

Шаблон Microsoft Visual Studio для ArcGIS Viewer for Silverlight устанавливается как часть ArcGIS Extensibility SDK for Silverlight. Этот шаблон позволяет быстро создавать настройки и компоновки для вьюера. Проекты, созданные с помощью шаблона, могут открываться в Microsoft Expression Blend 5, но сам шаблон появляется только в диалоговом окне создания проекта в Visual Studio. Шаблон поддерживается в Microsoft Visual Studio 2010 и 2012. Более ранние версии Visual Studio и Expression Blend не поддерживаются.

Примечание:

Если у вас имеются проекты Visual Studio, созданные в ArcGIS Extensibility SDK for Silverlight версии 2.4, необходимо обновить Target Silverlight Version до Silverlight 5 в свойствах проекта.

Предварительные условия

Чтобы использовать шаблон вьюера, необходимо следующее:

• Microsoft Visual Studio 2013, 2012 или 2010.
• ArcGIS API for Microsoft Silverlight 3.2.
• Microsoft Silverlight 5 Tools for Visual Studio 2010 SP1 (если используется Visual Studio 2010)
• Microsoft Silverlight Toolkit

Содержание шаблона Visual Studio

Решения Visual Studio, созданные по шаблону вьюера, включают три проекта. В списке, приведенном ниже, <Название проекта> означает имя проекта, как оно указано в диалоговом окне Новый проект. Проекты, созданные как часть шаблона, перечислены ниже:

• <Название проекта> – это проект веб-сайта, содержащего полнофункциональное приложение вьюера. Он содержит копию всех файлов конфигурации, которые входят в состав вьюера. Когда вы компилируете решение, выходные данные из проекта AddIns и компоновка из проекта Layouts автоматически копируются на этот веб-сайт.
• <Название проекта>.AddIns – содержит простой инструмент и поведение, позволяющие начать создание собственной надстройки. Подробнее смотрите в разделеСоздание инструмента и Создание поведения.
• <Название проекта>.Layouts – содержит копию компоновок по умолчанию, которые поставляются с вьюером. Их можно открыть в Visual Studio или Expression Blend, чтобы изменить дизайн или создать новую компоновку.
  Примечание:

  Чтобы просмотреть компоновки в Blend, сначала следует скомпилировать решение.

Создание и загрузка надстройки

Создание надстройки

Чтобы создать надстройку с помощью шаблона ArcGIS Viewer for Silverlight, выполните следующие шаги:

1. Откройте Microsoft Visual Studio 2010, 2012 или 2013.
2. Щелкните Файл (File) > Новый (New) > Проект (Project). Откроется диалоговое окно Новый проект (New Project).
3. В диалоговом окне Новый проект (New Project) разверните Visual C#, затем разверните узел Silverlight.
4. Щелкните Esri в узле Silverlight и выберите ArcGIS Viewer for Silverlight Project.
5. Введите имя проекта в текстовом поле Имя (Name) и щелкните OK. Смотрите следующий скриншот:

Решение надстройки загружается с тремя проектами: проект с кодом надстройки, с компоновкой и с веб-сайтом вьюера. Каждый проект содержит код и примеры, призванные помочь начать работу по созданию пользовательских инструментов, поведений и компоновок.

Загрузка надстройки

Ниже описывается, как загрузить надстройку в Конструктор приложения:

1. После создания надстройки в Visual Studio, постройте решение, чтобы получить файл .xap.
2. В Конструкторе приложения щелкните Настройки (Settings), затем щелкните закладку Надстройки (Add-Ins).
3. Щелкните Загрузить надстройки (Upload Add-Ins) и перейдите в папку, где находится сохраненный файл .xap. Нет необходимости записывать файл .xap в папку Конструктора, поскольку Конструктор автоматически копирует его в папку (например, C:\inetpub\wwwroot\Builder\Extensions). Смотрите следующий скриншот:
   Примечание:

   Вы можете увидеть сообщение "Сборка 'xyz' уже входит в приложение". Это просто предупреждение, надстройка все равно будет загружена. Чтобы убрать эту ошибку, вернитесь к решению Visual Studio и убедитесь, что для сборок, указанных в сообщении, задано Copy Local=False.

4. Щелкните кнопку Подробнее (Details), чтобы увидеть более подробную информацию о пакете надстройки. Откроется диалоговое окно Подробная информация о надстройке, как это показано на следующем рисунке:
5. Выйдите со страницы Настройки (Settings) и вернитесь на главную страницу Конструктора приложения.
6. Щелкните закладку Инструменты (Tools), затем щелкните кнопку Управлять (Manage). Появится диалоговое окно Управление панелями инструментов.
7. В списке Доступные инструменты (Available Tools) в окне Управление панелями инструментов (Manage Toolbars) найдите инструмент и щелкните кнопку Добавить (Add), чтобы добавить его на определенную панель.
8. Чтобы отредактировать свойства инструмента, такие как подсказка или надпись, щелкните кнопку Редактировать (Edit), или щелкните Закрыть (Close). Теперь инструмент добавлен на указанную панель. Кроме того, когда вы развертываете приложение, файл .xap копируется в папку Apps\<ViewerName>\Extensions автоматически (например, C:\inetpub\wwwroot\Apps\MyTestViewer\Extensions).

Отладка надстройки

Можно выполнить отладку надстройки с помощью Visual Studio. Отладку настройки вьюера лучше всего делать с помощью проекта веб-сайта вьюера. Для отладки надстройки в Конструкторе приложения, необходимо подключиться к процессу Конструктора приложения из Visual Studio.

Отладка с помощью проекта веб-сайта вьюера

Для отладки с помощью проекта веб-сайта вьюера выполните следующие шаги:

1. Задайте проект <Название проекта> как начальный. Если вы используете предложенный шаблон, это уже сделано.
2. Щелкните index.htm правой кнопкой мыши в проекте <Название проекта> и выберите Установить как начальную страницу (Set as Start Page). При отладке Visual Studio использует браузер по умолчанию. Если необходимо, щелкните index.htm правой кнопкой мыши и выберите Открыть с помощью (Browse With), чтобы выбрать другой браузер для отладки.
3. Щелкните правой кнопкой мыши проект <Название проекта> и выберите Свойства (Properties).
4. Щелкните закладку Web и убедитесь, что в разделе Отладчики (Debuggers) выбран Silverlight.
5. Сохраните изменения и закройте окно Свойства (Properties).
6. Постройте ваше решение и убедитесь, что процесс прошел без ошибок.
7. Добавьте точку прерывания в нужное место, и щелкните Отладка (Debug) > Начать отладку (Start Debugging). Вьюер откроет новое окно браузера.

Отладка в Конструкторе приложений с помощью подключения к процессу

Выполните следующие шаги, чтобы произвести отладку в Конструкторе приложений с помощью подключения к процессу:

1. Постройте ваше решение и убедитесь, что процесс прошел без ошибок.
2. Добавьте точку прерывания в нужное место.
3. Откройте Конструктор приложений в браузере по выбору.
4. Загрузите пакет надстройки в Конструктор приложения.
5. В Visual Studio щелкните Отладка (Debug) > Подключить к процессу (Attach to process). Откроется диалоговое окно Подключить к процессу (Attach to process), как показано на следующем рисунке:
6. Щелкните кнопку Выбрать (Select), чтобы задать свойство Подключить к (Attach to). Откроется диалоговое окно Выбрать тип кода (Select Code Type), как показано на следующем рисунке:
7. В диалоговом окне Выбрать тип кода (Select Code Type) отметьте Silverlight и щелкните OK.
8. В основном окне Подключить к процессу (Attach to Process) выберите процесс браузера (например, iexplore.exe если вы используете Internet Explorer), который имеет тип Silverlight и щелкните Подключить (Attach).