Предоставление сведений об упаковке и развертывании в элементах проекта
Все элементы проекта SharePoint в Visual Studio имеют свойства, которые можно использовать для предоставления дополнительных данных при развертывании проекта в SharePoint. Список содержит следующие свойства.
Свойства функций
Приемники компонентов
Выходные ссылки проекта
Записи безопасных элементов управления
Эти свойства отображаются в окне "Свойства ".
Свойства функций
Используйте свойство "Свойства компонентов", чтобы указать данные, используемые функцией. Данные свойств компонентов — это набор значений (хранящихся в виде пар "ключ-значение"), включенных в функцию при развертывании в SharePoint. После развертывания функции значения свойств можно использовать в коде.
При добавлении значения свойства компонента в элемент проекта значение добавляется в виде элемента в манифесте функции элемента. Например, в проекте модели бизнес-данных Подключение ivity (BDC) свойство компонента ModelFileName отображается следующим образом:
<Property Key="ModelFileName" Value="BdcModel1\BdcModel1.bdcm" />
После задания значения свойства компонента он добавляется в качестве элемента FeatureProperty в файле SPDATA проекта. Сведения о доступе к свойствам в SharePoint см . в классе SPFeaturePropertyCollection.
Идентичные значения свойств признаков из всех элементов проекта объединяются в манифест функции. Однако если два разных элемента проекта указывают один и тот же ключ свойства компонента со значениями без сопоставления, возникает ошибка проверки.
Чтобы добавить свойства компонента непосредственно в файл компонента (.feature), вызовите метод Addобъектной модели Visual Studio SharePoint. Если вы используете этот метод, помните, что то же правило о добавлении идентичных значений свойств признаков в свойства компонента также применяется к свойствам, добавленным непосредственно в файл компонента.
Приемник компонентов
Приемники функций — это код, который выполняется при возникновении определенных событий в элементе проекта, содержаемом компоненте. Например, можно определить приемники компонентов, которые выполняются при установке, активации или обновлении компонента. Одним из способов добавления приемника компонентов является добавление его непосредственно в функцию, как описано в пошаговом руководстве. Добавление приемников событий компонентов. Другим способом является ссылка на имя класса приемника признаков и сборку в свойстве Feature Receiver .
Прямой метод
При добавлении приемника компонентов непосредственно в компонент файл кода помещается под узел компонента в Обозреватель решений. При создании решения SharePoint код компилируется в сборку и развертывается в SharePoint. По умолчанию свойства компонента "Сборка приемника" и "Класс приемника" ссылается на имя класса и сборку.
Reference - метод
Другим способом добавления приемника компонентов является использование свойства приемника компонентов элемента проекта для ссылки на сборку приемника признаков. Значение свойства Приемника компонентов имеет два вложенных свойства: "Сборка " и "Имя класса". Сборка должна использовать полное, строгое имя, а имя класса должно быть полным именем типа. Подробнее см. в статье Сборки со строгими именами. После развертывания решения в SharePoint функция использует назначаемого приемника компонентов для обработки событий компонентов.
Во время сборки решения значения свойств приемника признаков в компоненте и его проектах объединяются, чтобы задать атрибуты ReceiverAssembly и ReceiverClass элемента Feature в манифесте компонента файла решения SharePoint (WSP). Таким образом, если значения свойств assembly и class Name элемента проекта и компонента указаны, то элемент проекта и значения свойств компонента должны совпадать. Если значения не совпадают, вы получите ошибку проверки. Если вы хотите, чтобы элемент проекта ссылал на сборку приемника компонентов, отличной от той, которая использует ее, переместите ее в другую.
Если вы ссылаетесь на сборку приемника компонентов, которая еще не находится на сервере, необходимо также включить сам файл сборки в пакет; Visual Studio не добавляет его для вас. При развертывании функции файл сборки копируется в глобальный кэш сборок системы (GAC) или папку Bin в физическом каталоге SharePoint. Дополнительные сведения см. в разделе " Практическое руководство. Добавление и удаление дополнительных сборок".
Дополнительные сведения о приемниках компонентов см. в разделе "Приемник событий компонентов" и "События компонентов".
Ссылки на выходные данные проекта
Свойство Project Output References указывает зависимость, например сборку, которую необходимо запустить элемент проекта. Например, предположим, что решение имеет проект BDC и проект класса. Если проект BDC имеет зависимость от сборки, выходной проектом класса, можно ссылаться на сборку в свойстве "Выходные данные проекта проекта BDC". Когда проект BDC упаковается, зависимые сборки включаются в пакет.
Ссылки на выходные данные проекта обычно являются сборками, но в некоторых случаях (например, проекты Silverlight) могут быть другими типами файлов.
Дополнительные сведения см. в разделе "Практическое руководство. Добавление ссылки на выходные данные проекта".
записи элемента управления Сейф
SharePoint предоставляет механизм безопасности, называемый записями безопасного управления, чтобы ограничить доступ ненадежных пользователей к определенным элементам управления. По проектированию SharePoint позволяет ненадежным пользователям отправлять и создавать страницы ASPX на сервере SharePoint. Чтобы предотвратить добавление небезопасного кода на страницы ASPX, SharePoint ограничивает доступ к безопасным элементам управления. Сейф элементы управления — это элементы управления ASPX и веб-части, назначенные как безопасные, и которые могут использоваться любым пользователем на сайте. Дополнительные сведения см. в шаге 4. Добавление веб-части в список элементов управления Сейф.
Каждый элемент проекта SharePoint в Visual Studio имеет свойство Сейф Элемент управления с двумя логическими подпроцентами: Сейф и Сейф против скрипта. Свойство "Безопасно" определяет, возможен ли доступ к элементу управления для недоверенных пользователей. Свойство Сейф Against Script указывает, могут ли ненадежные пользователи просматривать и изменять свойства элемента управления.
Сейф записи элементов управления ссылаются на сборку. Вы добавляете записи безопасного элемента управления в сборку проекта, введя их в свойство Сейф элемента управления. Однако можно также добавить записи безопасного элемента управления в сборку проекта с помощью вкладки "Дополнительно " в конструкторе пакетов при добавлении дополнительной сборки в пакет. Дополнительные сведения см. в статье "Практическое руководство. Пометить элементы управления как безопасные элементы управления или регистрация сборки веб-частей в качестве элемента управления Сейф".
XML-записи для безопасных элементов управления
При добавлении записи безопасного элемента управления в элемент проекта или в сборку проекта ссылка записывается в манифест пакета в следующем формате:
<Assemblies>
<Assembly Location="<assembly name>.dll"
DeploymentTarget="<'GlobalAssemblyCache' or 'WebApplication'">>
<SafeControls>
<SafeControl Assembly="<assembly name>.dll" Namespace=
"<SharePoint project name>" Safe="<true/false>"
TypeName="<control name>"
SafeAgainstScript="<true/false>" />
</SafeControls>
</Assembly>
</Assemblies>