Устранение неполадок с упаковкой и развертыванием SharePoint
В разделе рассмотрены различные проблемы, которые могут возникнуть при упаковке и развертывании решений SharePoint.
Включение расширенной отладки
Чтобы выявить причины неполадок в Visual Studio, SharePoint и на других уровнях, можно воспользоваться разделом реестра EnableDiagnostics для просмотра трассировки стека. Дополнительные сведения см. в разделе "Отладка решений SharePoint".
Добавление выходных данных проекта в пакет решения
Выходные данные проекта можно добавлять с помощью "Конструктора пакетов". Однако при добавлении выходных данных пакета, убедитесь, что платформа проекта соответствует платформе решения SharePoint. Рекомендуется использовать целевой объект любой платформы ЦП для сборок, которые требуется развернуть на сервере SharePoint. Дополнительные сведения см. в разделе "Страница компиляции", "Конструктор проектов" (Visual Basic) и диалоговое окно расширенного компилятора Параметры (Visual Basic).
Предупреждения и ошибки проверки
Средства разработки SharePoint в Visual Studio выполняют проверочные шаги для проверки правильности формирования пакета решения. Также, для компонентов и пакетов, можно создать пользовательские проверочные шаги. Дополнительные сведения см. в статье "Практическое руководство . Создание правил пользовательской функции и проверки пакетов для решений SharePoint".
Разрешение конфликтов развертывания
При развертывании решения SharePoint может возникнуть конфликт, когда элемент на сервере и элемент в пакете решения имеют одинаковое имя, URL-адрес или идентификатор. Вы можете изменить свойство разрешения конфликтов развертывания, чтобы разрешить, сообщить или игнорировать столкновения для модулей, веб-частей, экземпляров списка и типов контента.
В следующей таблице показаны параметры свойства "Разрешение конфликтов развертывания".
| значение | Описание |
|---|---|
| Автоматически | Обнаруживает и разрешает конфликты автоматически. |
| Prompt | Обнаруживает и выводит отчет о конфликтах для разработчика перед их разрешением. |
| нет | Не обнаруживает конфликты. |
Различия между развертыванием F5
При использовании Visual Studio для развертывания проекта SharePoint на локальном сервере SharePoint для тестирования и отладки есть несколько дополнительных шагов, выполняемых Visual Studio.
Сброс службы IIS во время выполнения развертывания.
Автоматическое назначение рабочих процессов.
Задание в конструкторе пакетов порядка активации компонентов в соответствии с иерархией.
Вы можете добавить настраиваемые шаги развертывания для дальнейшего изменения поведения F5 . Дополнительные сведения см. в пошаговом руководстве. Создание пользовательского шага развертывания для проектов SharePoint.
Задержка отображения страницы SharePoint при развертывании визуальной веб-части
Страница SharePoint занимает много времени при развертывании визуальной веб-части в папке Bin в Windows Vista, Windows 7 или Windows Server 2008. При изменении файлов в каталоге верхнего уровня ASP.NET, например в каталоге Bin, выполняется повторная компиляция всего веб-приложения. Это может привести к задержке рендеринга страницы SharePoint до 25 секунд.
Сообщение об ошибке
Нет.
Разрешение
Чтобы решить эту проблему, выполните следующие действия:
Установите обновление КБ967535, как описано в статье исправление служба поддержки Майкрософт: исправление доступно для устранения двух проблем в ASP.NET в IIS 7.0 для Windows Vista и Windows Server 2008.
Добавьте следующую строку в файл Web.config:
<compilation batch="false" optimizeCompilations="true">
Развертывание проекта SharePoint завершается ошибкой "Не удалось извлечь cab-файл в решении"
Если имя любого элемента проекта SharePoint содержит круглые скобки, при развертывании решения возникнет ошибка.
Сообщение об ошибке
Ошибка в шаге развертывания "Добавление решения": В решении не удалось извлечь CAB-файл.
Разрешение
Чтобы решить эту проблему, удалите круглые скобки в именах элементов проектов SharePoint.
Ошибка возникает при развертывании визуальной веб-части на сайте в другом веб-приложении
При первом развертывании визуальной веб-части на сайт веб-приложения, отличного от развернутого в настоящий момент (в результате изменения свойства веб-части SiteUrl), возникает сообщение об ошибке.
Сообщение об ошибке
Ошибка в шаге развертывания "Добавление решения": Компонент с идентификатором [#] уже установлен для данной фермы. Используйте атрибут "force" для явной переустановки компонента.
Разрешение
Эта ошибка возникает из-за механизма отзыва компонентов визуальных веб-частей в SharePoint. Чтобы успешно развернуть визуальную веб-часть, разверните решение еще раз, выбрав клавишу F5 .
Предупреждение появляется при развертывании вложенных пользовательских элементов управления
Это предупреждение появляется при развертывании решения SharePoint, которое содержит вложенные пользовательские элементы управления, например визуальная веб-часть содержит пользовательский элемент управления или пользовательский элемент управления содержит веб-часть или другой пользовательский элемент управления. Это предупреждение возникает при добавлении элемента управления в конструктор путем перетаскивания его из панели элементов или с помощью @Register директивы в представлении источника.
Сообщение об ошибке
Предупреждение 1 Элемент "[Имя элемента управления]" не является известным элементом. Это может произойти, если существует ошибка компиляции или отсутствует файл web.config.
Разрешение
Если система проектов Visual Studio не знает вложенного пользовательского элемента управления, она не может предоставить IntelliSense и выдает предупреждение. Система проектов не знает о вложенном пользовательском элементе управления, если проект не создан, и конструктор не закрыт и повторно открыт, или если включен параметр автоматического отзыва, что приводит к извлечению пользовательского элемента управления из куста SharePoint после отладки.
Чтобы удалить это предупреждение, постройте проект, закройте и повторно откройте конструктор или отключите параметр автоматического отзыва для проекта. Для этого снимите флажок автоматического извлечения после отладки проверка на вкладке SharePoint диалогового окна свойств проекта.