Шаблон Visual Studio

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

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

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

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

• Microsoft Visual Studio 2010 или Microsoft Visual Web Developer 2010 Express.
• ArcGIS API for Microsoft Silverlight 2.4.
• Expression Blend 4 SDK.
• Microsoft Silverlight 4 Tools for Visual Studio 2010
• Microsoft Silverlight Toolkit

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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).