Образец пользовательского элемента отчета

Статья
12/15/2008

Добавления: 5 декабря 2005 г.

PolygonsCRI — простой образец пользовательского элемента отчета. Он пользуется классами System.Component из среды Microsoft .NET Framework и классами из пространств имен Microsoft.ReportDesigner и Microsoft.ReportingServices для реализации компонентов времени разработки и времени выполнения, которые могут применяться в построителе отчетов.

При установке SQL Server образцы автоматически не устанавливаются. Указания по установке образцов см. в разделе Установка образцов.

Важно!
Образцы предназначены только для учебных целей. Они не предназначены для использования в производственной среде и не тестировались в ней. Корпорация Майкрософт не предоставляет техническую поддержку для этих образцов. Образцы приложений и сборок не должны подключаться к рабочей базе данных SQL Server или серверу отчетов, а также использоваться с ними без разрешения системного администратора.

Образцы предназначены только для учебных целей. Они не предназначены для использования в производственной среде и не тестировались в ней. Корпорация Майкрософт не предоставляет техническую поддержку для этих образцов. Образцы приложений и сборок не должны подключаться к рабочей базе данных SQL Server или серверу отчетов, а также использоваться с ними без разрешения системного администратора.

Требования

Для работы с образцом PolygonsCRI необходимы навыки работы с Visual Studio и Microsoft Visual C#, а система должна отвечать следующим требованиям:

Microsoft SQL Server 2005 со службами Reporting Services;
среда Microsoft SQL Server Business Intelligence Development Studio;
Microsoft Visual Studio 2005;
платформа Microsoft .NET Framework версии 2.0.

Образцы служб Reporting Services. Сервер отчетов, на доступ к которому у пользователя имеется разрешение.

Примечание.
Работа среды Business Intelligence Development Studio и Visual Studio 2005 на компьютерах на базе Itanium не поддерживаются. Однако они совместимы с архитектурой x64. Если образцы баз данных SQL Server 2005 были развернуты на компьютере на базе Itanium, то для изменения и выполнения образцов используйте среду BI Development Studio или Visual Studio на компьютере x86 или x64.

Работа среды Business Intelligence Development Studio и Visual Studio 2005 на компьютерах на базе Itanium не поддерживаются. Однако они совместимы с архитектурой x64. Если образцы баз данных SQL Server 2005 были развернуты на компьютере на базе Itanium, то для изменения и выполнения образцов используйте среду BI Development Studio или Visual Studio на компьютере x86 или x64.

Расположение

Образец расположен в подкаталоге \Extension Samples\CustomReportItem Sample каталога образцов служб Reporting Services.

Например:

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\CustomReportItem Sample

Построение образца

Если файл ключа для строгого имени еще не создавался, создайте его следующим образом.

To generate a strong name key file

Откройте командную строку Microsoft Visual Studio 2005. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

-- или --

Откройте командную строку Microsoft .NET Framework. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

Используйте команду CD, чтобы сменить текущий каталог командной строки и перейти в каталог, в котором установлены образцы.

Примечание.
Чтобы определить каталог, в котором установлены образцы, нажмите кнопку Пуск, укажите пункты Все программы, Microsoft SQL Server, Документация и учебные материалы, а затем выберите пункт Каталог образцов. Если использовался каталог установки по умолчанию, то образцы расположены в каталоге «<системный_диск>:\Program Files\Microsoft SQL Server\100\Samples».

Чтобы определить каталог, в котором установлены образцы, нажмите кнопку Пуск, укажите пункты Все программы, Microsoft SQL Server, Документация и учебные материалы, а затем выберите пункт Каталог образцов. Если использовался каталог установки по умолчанию, то образцы расположены в каталоге «<системный_диск>:\Program Files\Microsoft SQL Server\100\Samples».

В командной строке выполните следующую команду, чтобы создать файл ключа:

sn -k SampleKey.snk

Важно!
Дополнительные сведения о паре ключей для строгого имени см. в статье по строгим именам и безопасности для платформы .NET Framework в центре разработчиков .NET в MSDN.

Построение образца PolygonsCRI

Откройте 2005 файл проекта PolygonsCRI.sln в Visual Studio.
В меню Построить выберите пункт Построить решение.
Откройте файл проекта PolygonsCRI.sln в Visual Studio.

Развертывание образца

Развертывание образца PolygonsCRI

Произведите редактирование файла rsreportserver.config, зарегистрировав в нем образец PolygonsCRI:
- Перед элементом </Extensions> вставьте следующие строки:
```
<ReportItems>
   <ReportItem Name="Polygons" Type="Microsoft.Samples.ReportingServices.PolygonsCCustomReportItem,PolygonsCRI"/>
</ReportItems>
```

Произведите редактирование файла rssrvpolicy.config, добавив в него группу кода для пользовательского элемента отчета:

Добавьте следующие строки:

<CodeGroup 
   class="UnionCodeGroup" 
   version="1" 
   PermissionSetName="FullTrust"
   Description="This code group grants PolygonsCRI.dll FullTrust permission. ">
   <IMembershipCondition 
   class="UrlMembershipCondition"
   version="1"
   Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\PolygonsCRI.dll" />
</CodeGroup>

Произведите редактирование файла rsreportdesigner.config, зарегистрировав в нем компонент времени выполнения, компонент времени проектирования и преобразователь типов элементов:

Перед элементом </Extensions> добавьте следующие строки:

<ReportItems>
   <ReportItem Name="Polygons" Type="Microsoft.Samples.ReportingServices.PolygonsCCustomReportItem,PolygonsCRI"/>
</ReportItems>
<ReportItemDesigner>
   <ReportItem Name="Polygons" Type=" Microsoft.Samples.ReportingServices.PolygonsDesigner, PolygonsDesigner" />
</ReportItemDesigner>
<ReportItemConverter>
   <Converter Source="Chart" Target="Polygons" Type=" Microsoft.Samples.ReportingServices.PolygonsConverter, PolygonsDesigner" />
</ReportItemConverter>

Скопируйте файл PolygonsCRI.dll из каталога \PolygonCRI\Bin\Debug, куда был скопирован образец проекта, в собственный каталог сборок Visual Studio (по умолчанию это каталог \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).
Скопируйте файл PolygonsCRI.dll из каталога \PolygonCRI \Bin\Debug, куда был скопирован образец проекта, в каталог исполняемых файлов служб Microsoft SQL Server Reporting Services (по умолчанию это каталог \Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\Bin).
Скопируйте файл PolygonsDesigner.dll из каталога \PolygonDesigner\Bin\Debug в собственный каталог сборок Visual Studio (по умолчанию это каталог \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies).

Выполнение образца

Краткое пошаговое руководство, содержащееся в данном разделе, демонстрирует создание ссылки на пользовательский элемент отчета Polygon в среде Visual Studio и его последующее тестирование.

Добавление элемента PolygonDesigner в область элементов Visual Studio

Щелкните правой кнопкой область элементов Visual Studio.
Выберите пункт Выбрать элементы.
Перейдите в папку \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies и выберите PolygonsDesigner.dll.

Запуск образца

Откройте образец проекта отчета \PolygonsReport\Polygons.sln в Visual Studio.
Перейдите в образце отчета на вкладку Предварительный просмотр, либо произведите развертывание на сервере и запустите его.

При редактировании в Visual Studio отчета, использующего элемент управления PolygonDesigner, можно:

задавать свойства элемента управления polygons в обозревателе свойств;
редактировать свойства через контекстное меню элемента управления;
перетаскивать поля из списка полей в соответствующие области элемента управления;
выбрать диаграмму и в контекстном меню указать пункт Преобразовать в Polygons.

См. также

Поделиться через