Пошаговые руководства для разработчиков Данный документ предоставляется «как есть». Информация и взгляды, представленные в данном документе, включая URL-адреса и другие ссылки на веб-сайты в Интернете, могут быть изменены без уведомления. Риск, связанный с его использованием, несет читатель. Некоторые примеры, приводимые здесь, предоставлены только для иллюстрации и являются вымышленными. Любые совпадения с реально существующими объектами следует рассматривать как случайные. Данный документ не дает вам каких-либо законных прав на любую интеллектуальную собственность в любых продуктах Майкрософт. Разрешается копирование и использование данного документа для внутренних справочных целей. © Корпорация Майкрософт (Microsoft Corporation), 2010. Все права защищены. Microsoft, SharePoint, Visual Studio, InfoPath и Visio являются товарными знаками группы компаний Майкрософт. Все остальные товарные знаки являются собственностью их владельцев. Страница 1 Пошаговые руководства для разработчиков SharePoint 2010 Содержание Упражнение 1. Пошаговое руководство по созданию веб-части с помощью Linq ......................................... 4 Задача 1. Создание нового проекта SharePoint ............................................................................................ 4 Задача 2. Создание прокси-класса LINQ-to-SharePoint для обращения к данным списка ....................... 7 Задача 3. Обращение к данным списка SharePoint в визуальной веб-части ........................................... 10 Задача 4. Построение и развертывание визуальной веб-части ................................................................ 12 Упражнение 2. Построение внешнего типа контента BCS ............................................................................. 17 Задача 1. Создание проекта модели каталога бизнес-данных ................................................................. 17 Задача 2. Обновление схемы класса сущностей ........................................................................................ 18 Задача 3. Обновление кода службы ............................................................................................................ 29 Задача 4. Построение и развертывание ...................................................................................................... 31 Упражнение 3. Создание приложения Silverlight для клиентской объектной модели SharePoint ............... 35 Задача 1. Создание проекта приложения Silverlight ................................................................................... 35 Задача 2. Написание кода для обращения к данным списка SharePoint и их визуализации ................. 37 Задача 3. Развертывание веб-части SharePoint Silverlight и ее тестирование ........................................ 41 Упражнение 4. Создание графа с помощью объектной модели SharePoint и графических элементов управления Silverlight ......................................................................................................................................... 43 Задача 1. Создание проекта приложения Silverlight ................................................................................... 43 Задача 2. Создание кода для обращения к данным списка Employee SharePoint и отображения его в элементе управления Silverlight Graph ........................................................................................................ 47 Задача 3. Развертывание веб-части SharePoint Silverlight для построения диаграмм и ее тестирование .................................................................................................................................................. 50 Упражнение 5. Создание веб-части для изолированного решения .............................................................. 54 Задача 1. Создание проекта изолированного решения с веб-частью ...................................................... 54 Задача 2. Добавление кода, отвечающего за запросы и визуализацию .................................................. 56 Задача 3. Построение и развертывание изолированного решения .......................................................... 59 Упражнение 6. Создание действия для использования в рабочем процессе конструктора SharePoint .... 64 Задача 1. Создание и подготовка проекта ................................................................................................... 64 Задача 2. Создание нового действия рабочего процесса, используемого рабочим процессом для повторного использования ............................................................................................................................ 66 Задача 3. Добавление кода, отвечающего за создание библиотеки документов на основе параметров, переданных в действие ................................................................................................................................. 68 Задача 4. Подготовка действия к развертыванию. ..................................................................................... 71 Задача 5. Добавление действия SPDActivityDemo, которое будет развернуто с помощью SPCHOL305Ex1. ............................................................................................................................................. 76 Задача 6. Настройка компонента с помощью конструктора компонентов ................................................ 78 Задача 7. Добавление кода в приемник компонента .................................................................................. 78 Задача 8. Создание рабочего процесса для повторного использования с помощью конструктора SharePoint ....................................................................................................................................................... 79 Задача 9. Импорт рабочего процесса для повторного использования в Visual Studio ........................... 87 Задача 10. Сопоставление рабочего процесса со списком в SharePoint ................................................. 94 Сводка по пошаговым руководствам ................................................................................................................ 97 Страница 2 Пошаговые руководства для разработчиков SharePoint 2010 Следующие шесть руководств являются пошаговыми, иллюстрирующими ряд сценариев на C#, с которыми профессиональные разработчики столкнутся при использовании Visual Studio 2010 в SharePoint 2010. В этих пошаговых руководствах содержится достаточное количество снимков экрана, чтобы изучать документы, не имея практического доступа к соответствующему программному обеспечению. Эти руководства для разработчиков также доступны в виде практических занятий как часть данного курса eLearning: http://msdn.microsoft.com/ru-ru/sharepoint/ee513148.aspx (Возможно, на английском языке). В этом курсе также имеются дополнительные практические занятия, видеоматериалы, примеры кода и сетевые виртуальные лабораторные среды, а также практические занятия, доступные как на C#, так и на VB.NET. Отзывы об этом руководстве направляйте по электронной почте на адрес [email protected]. Страница 3 Пошаговые руководства для разработчиков SharePoint 2010 Упражнение 1. Пошаговое руководство по созданию веб-части с помощью Linq На выполнение этого упражнения понадобится примерно: 10 минут В этом упражнении будет разработана и развернута веб-часть, которая считывает данные из списка и отображает их в элементе DataGrid. В ходе этого упражнения будут выполнены следующие действия: 1. Создание визуальной веб-части. 2. Создание прокси-кода Linq. 3. Использование поставщика Linq для считывания данных из списка SharePoint. 4. Отображение данных с помощью веб-элемента управления SPDataGrid. Задача 1. Создание нового проекта SharePoint В ходе этой задачи будут созданы решение и проект. В нее будет входить оставшаяся часть работы по разработке из упражнения 1 данного практического занятия. 1. Откройте Visual Studio 2010, последовательно выбрав элементы Пуск | Все программы | Microsoft Visual Studio 2010 | Microsoft Visual Studio 2010. 2. В меню последовательно выберите пункты Файл | Создать | Проект. 3. В диалоговом окне создания проекта выберите в установленных шаблонах элементы Visual C# | SharePoint | 2010. 4. В элементах проекта выберите пункт Визуальная веб-часть. Страница 4 Пошаговые руководства для разработчиков SharePoint 2010 Рисунок 1. Проект визуальной веб-части SharePoint 2010 5. В поле «Имя» введите SPCHOL200-Ex1. 6. В поле «Расположение» введите C:\SPHOLS\SPCHOL200\CS\Ex1. 7. Снимите флажок «Создать каталог для решения». 8. Нажмите кнопку OK. 9. В мастере настройки SharePoint выполните следующие действия. Укажите http://intranet.contoso.com/ в качестве локального сайта. Установите в качестве уровня доверия значение Развернуть как решение фермы. Нажмите кнопку Готово. Страница 5 Пошаговые руководства для разработчиков SharePoint 2010 Рисунок 2. Мастер настройки SharePoint 10. Visual Studio создаст новый проект с именем SPCHOL200-Ex1 и добавит в него все необходимые файлы. Рисунок 3. Проект SPCHOL200-Ex1 Страница 6 Пошаговые руководства для разработчиков SharePoint 2010 11. Обратите внимание, что Visual Studio также создаст визуальную веб-часть с именем VisualWebPart1. В обозревателе решений разверните узел VisualWebPart1 и откройте VisualWebPart1.webpart. Рисунок 4. Визуальная веб-часть 12. Измените значение атрибута имени с Title на SPLinqDemoTitle, а значение атрибута описания — с Description на SPLinqDemoPart Description. Это изменит значения свойств Title и Description визуальной веб-части при ее развертывании. Сохраните файл. <properties> <property name="Title" type="string">SPLinqDemoTitle</property> <property name="Description" type="string">SPLinqDemoPart Description</property> </properties> Задача 2. Создание прокси-класса LINQ-to-SharePoint для обращения к данным списка В ходе этой задачи будет использована новая служебная программа по созданию кода spmetal.exe и создан прокси-код Linq-to-SharePoint. 1. В обозревателе решений щелкните правой кнопкой мыши SPCHOL200-Ex1 и выберите пункт Открыть папку в проводнике Windows. 2. Удерживая нажатой клавишу Shift и щелкнув правой кнопкой мыши где-либо в окне проводника, выберите пункт Открыть окно команд, чтобы открыть окно командной строки в каталоге текущего проекта: Страница 7 Пошаговые руководства для разработчиков SharePoint 2010 Рисунок 5. Открытие окна командной строки 3. Введите в командной строке следующую команду и нажмите клавишу ВВОД, чтобы задать путь к папке SharePoint 2010: set path=%path%;c:\program files\common files\microsoft shared\web server extensions\14\bin 4. Введите в командной строке следующую команду и нажмите клавишу ВВОД, чтобы создать прокси-код Linq-to-SharePoint: spmetal.exe /web:http://intranet.contoso.com /namespace:SPCHOL200_Ex1.VisualWebPart1 /code:SPLinq.cs Примечание. Могут появиться предупреждения о типах контента для шаблонов форм типа «Список». Это предупреждение можно спокойно проигнорировать и продолжить. 5. Закройте окно командной строки и вернитесь в Visual Studio. 6. В Visual Studio щелкните правой кнопкой мыши проект SPCHOL200-Ex1 и последовательно выберите пункты Добавить | Существующий элемент. Рисунок 6. Добавление существующего элемента 7. В диалоговом окне Добавление существующего элемента выберите элемент SPLinq.cs и нажмите кнопку Добавить: Страница 8 Пошаговые руководства для разработчиков SharePoint 2010 Рисунок 7. Добавление файла SPLinq.cs 8. В обозревателей решений правой кнопкой мыши щелкните пункт Ссылки и выберите команду Добавить ссылку. 9. Перейдите на вкладку Обзор и укажите строку C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI в поле Имя файла. Нажмите клавишу ВВОД, чтобы изменить каталоги. Окно «Добавление ссылки» теперь должно выглядеть, как показано на рисунке 8. 10. Выберите Microsoft.SharePoint.Linq.dll. Страница 9 Пошаговые руководства для разработчиков SharePoint 2010 Рисунок 8. Добавление ссылки 11. Нажмите кнопку OK, чтобы добавить ссылку в проект. Задача 3. Обращение к данным списка SharePoint в визуальной веб-части В ходе этой задачи в решение будет добавлен код, позволяющий визуальной веб-части извлекать данные из списка SharePoint. 1. В обозревателе решений разверните узел VisualWebPart1 и дважды щелкните пункт VisualWebPart1UserControl.ascx. 2. Visual Studio откроет пользовательский элемент управления Visual Web Part. 3. Добавьте в этот пользовательский элемент управления следующий код, чтобы построить представление таблицы. Страница 10