Printer Delivery Extension サンプル

[アーティクル]
12/15/2008

更新 : 2005 年 12 月 5 日

Printer Delivery サンプルは、Reporting Services 配信機能を紹介するためのサンプルの配信拡張機能です。このサンプルは、プリンタ用の単純な配信拡張機能です。Microsoft .NET Framework の System.Drawing.Printing 名前空間と合わせて画像表示拡張機能を使用し、レポートをプリンタに配信します。このサンプルは、Itanium ベースのオペレーティングシステムではサポートされていません。

SQL Server サンプルは、セットアップ中に自動的にインストールされません。これらのサンプルをインストールする方法の詳細については、「サンプルのインストール」を参照してください。

重要 :
サンプルは、学習に使用することのみを目的に提供されています。これらは、運用環境での使用を目的としたものではなく、運用環境でのテストも実施されていません。マイクロソフトからは、これらのサンプルについてのテクニカルサポートは提供されません。サンプルアプリケーションおよびサンプルアセンブリは、システム管理者の許可なしに、運用中の SQL Server データベースやレポートサーバーに接続しないようにしてください。

サンプルは、学習に使用することのみを目的に提供されています。これらは、運用環境での使用を目的としたものではなく、運用環境でのテストも実施されていません。マイクロソフトからは、これらのサンプルについてのテクニカルサポートは提供されません。サンプルアプリケーションおよびサンプルアセンブリは、システム管理者の許可なしに、運用中の SQL Server データベースやレポートサーバーに接続しないようにしてください。

必要条件

Printer Delivery サンプルを使用するには、Visual Studio および Microsoft Visual C# について理解していることと、使用するシステムで次の要件が満たされていることが必要です。

Microsoft Visual Studio 2005。
Microsoft .NET Framework Version 2.0。
Reporting Services のサンプル。
アクセス権を持つネットワーク上のレポートサーバー (このサンプル拡張機能を使用して、他のデータ処理機能をサーバーに追加する場合)。

場所

このサンプルは、Reporting Services サンプルディレクトリの Extension Samples\PrinterDelivery Sample サブディレクトリにあります。

次に例を示します。

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

サンプルのビルド

次の手順に従ってサンプルをビルドします。

強力な名前のキーファイルをまだ作成していない場合は、次の指示に従ってキーファイルを生成してください。

厳密な名前のキーファイルを生成するには

Microsoft Visual Studio 2005 コマンドプロンプトを開きます。[スタート] メニューの [すべてのプログラム] をポイントし、[Microsoft .NET Framework SDK 2.0] をポイントします。次に、[SDK コマンドプロンプト] をクリックします。

-- または --

Microsoft .NET Framework コマンドプロンプトを開きます。[スタート] メニューの [すべてのプログラム] をポイントし、[Microsoft .NET Framework SDK 2.0] をポイントします。次に、[SDK コマンドプロンプト] をクリックします。

ディレクトリの移動コマンド (CD) を使用して、コマンドプロンプトウィンドウの現在のディレクトリから、サンプルがインストールされているフォルダに移動します。

注 :
サンプルが配置されているフォルダを調べるには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft SQL Server]、[マニュアルとチュートリアル] の順にポイントして、[サンプルディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\100\Samples にあります。

サンプルが配置されているフォルダを調べるには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft SQL Server]、[マニュアルとチュートリアル] の順にポイントして、[サンプルディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\100\Samples にあります。

コマンドプロンプトで、次のコマンドを実行してキーファイルを生成します。

sn -k SampleKey.snk

重要 :
厳密な名前のキーペアの詳細については、MSDN の .NET Development Center にある「Security Briefs: Strong Names and Security in the .NET Framework」を参照してください。

.NET Framework SDK を使用してこのサンプルをコンパイルするには、次の操作を行います。

レポートサーバーの \bin ディレクトリから、Microsoft.ReportingServices.Interfaces.dll をサンプルフォルダにコピーします。既定では、Microsoft.ReportingServices.Interfaces.dll は、インストールされた Reporting Services のインスタンスの \Reporting Services\ReportServer\bin サブディレクトリにあります。正確なパスは、Reporting Services のインストールによって変わる可能性があります。例 :
```
C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager\Bin
```
次のコマンドを発行し、サンプル配信処理拡張機能、Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll を作成します。
```
csc /t:library /out:Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll *.cs /r:Microsoft.ReportingServices.Interfaces.dll
```

Visual Studio を使用してこのサンプルをコンパイルするには

Visual Studio でサンプルソリューションファイル (PrinterDeliveryCS.sln または PrinterDeliveryVB.sln) を開きます。
ソリューションエクスプローラで、PrinterDelivery プロジェクトを選択します。
[プロジェクト] メニューの [参照の追加] をクリックします。

[参照の追加] ダイアログボックスが表示されます。
[.NET] タブをクリックします。
[参照] をクリックし、ローカルドライブにある Microsoft.ReportingServices.Interfaces.dll ファイルの場所に移動します。既定では、このアセンブリは、C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin にあります。選択したら、[OK] をクリックします。

選択した参照が、プロジェクトに追加されます。
[ビルド] メニューの [ソリューションのビルド] をクリックします。

サンプルの配置

上記の作業を完了したら、Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll をレポートサーバーおよびレポートマネージャに配置し、レポートの配信に使用できます。

サンプルを配置するには

Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll をレポートサーバーにコピーします。レポートサーバー拡張機能の既定の場所は、C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin です。

次のエントリを RSReportServer.config ファイルの <Delivery> 要素に追加します。

<Extension Name="Printer Delivery Sample" Type="Microsoft.Samples.ReportingServices.PrinterDelivery.PrinterDeliveryProvider,Microsoft.Samples.ReportingServices.PrinterDeliverySample">
   <Configuration>
      <Printers>
         <Printer>\\Server\MyNetworkPrinter1</Printer>
         <Printer>\\Server\MyNetworkPrinter2</Printer>
         <Printer>MyLocalPrinter</Printer>
      </Printers>
   </Configuration>
</Extension>

メモ :
<Printers> 要素は、配信拡張機能の Printer 設定で、プリンタ名の固定セットを取得できるようにするためのものです。この一覧は、最終的に、配信拡張機能がインストールされているレポートサーバーで利用できる既知のプリンタ一覧と比較して検証されます。選択したプリンタが、レポートサーバーにインストールされている既知のプリンタ一覧にない場合は、配信は失敗し、"プリンタ <プリンタ名> は、現在サーバーにインストールされていません。" というステータスが返されます。レポートサーバーに使用される Windows サービスアカウントに Windows にインストールされているプリンタへの印刷権限が与えられていない場合、そのプリンタは使用できるプリンタの一覧には含まれません。

<Printers> 要素は、配信拡張機能の Printer 設定で、プリンタ名の固定セットを取得できるようにするためのものです。この一覧は、最終的に、配信拡張機能がインストールされているレポートサーバーで利用できる既知のプリンタ一覧と比較して検証されます。選択したプリンタが、レポートサーバーにインストールされている既知のプリンタ一覧にない場合は、配信は失敗し、"プリンタ <プリンタ名> は、現在サーバーにインストールされていません。" というステータスが返されます。レポートサーバーに使用される Windows サービスアカウントに Windows にインストールされているプリンタへの印刷権限が与えられていない場合、そのプリンタは使用できるプリンタの一覧には含まれません。

このサンプルアセンブリをレポートマネージャにコピーします。レポートマネージャの拡張機能の既定の場所は、C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager\bin です。

次のエントリを RSWebApplication.config ファイルの <DeliveryUI> 要素に追加します。

<Extension Name="Printer Delivery Sample" Type="Microsoft.Samples.ReportingServices.PrinterDelivery.PrinterDeliveryUIProvider,Microsoft.Samples.ReportingServices.PrinterDeliverySample"/>

配信拡張機能の詳細については、「配信拡張機能の配置」を参照してください。

サンプルのコードアクセスセキュリティを構成するには

レポートサーバーのポリシー構成ファイル (rssrvpolicy.config) を開きます。このファイルの既定の場所は、C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer です。

配信拡張機能に、完全な信頼を与える必要があります。この操作を行うには、<CodeGroup … Zone="MyComputer" /> 要素に次のコードグループ情報を追加します。

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="PrinterDeliveryCodeGroup"
   Description="Code group for my delivery extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll"
       />
</CodeGroup>

レポートマネージャでサンプルプリンタ配信拡張機能を使用している場合は、レポートマネージャのポリシー構成ファイル (rsmgrpolicy.config) および次のコードグループを使用して手順 1. および 2. を繰り返します。

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="PrinterDeliveryCodeGroup"
   Description="Code group for my delivery extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager\bin\Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll"
       />
</CodeGroup>

rsmgrpolicy.config ファイルの既定の場所は、C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager です。

サンプルの配置が終了したら、再設定ツールの Iisreset.exe を使用して Microsoft インターネットインフォメーションサービス (IIS) を再設定し、Reporting Services Windows サービスを再起動します。

.NET セキュリティと Reporting Services の詳細については、「Reporting Services のコードアクセスセキュリティの理解」を参照してください。

参照

変更履歴

リリース	履歴
2005 年 12 月 5 日	変更内容 : キーファイルの名前や場所など、キーファイルを生成する手順を変更しました。

次の方法で共有

Printer Delivery Extension サンプル

必要条件

場所

サンプルのビルド

厳密な名前のキーファイルを生成するには

.NET Framework SDK を使用してこのサンプルをコンパイルするには、次の操作を行います。

Visual Studio を使用してこのサンプルをコンパイルするには

サンプルの配置

サンプルを配置するには

サンプルのコードアクセスセキュリティを構成するには

参照

処理手順

その他の技術情報

ヘルプおよび情報

変更履歴

その他のリソース

次の方法で共有

Printer Delivery Extension サンプル

必要条件

場所

サンプルのビルド

厳密な名前のキー ファイルを生成するには

.NET Framework SDK を使用してこのサンプルをコンパイルするには、次の操作を行います。

Visual Studio を使用してこのサンプルをコンパイルするには

サンプルの配置

サンプルを配置するには

サンプルのコード アクセス セキュリティを構成するには

参照

処理手順

その他の技術情報

ヘルプおよび情報

変更履歴

その他のリソース

厳密な名前のキーファイルを生成するには

サンプルのコードアクセスセキュリティを構成するには