Report Application Server へのバインド(Crystal Reports 9 以降)
注 |
---|
このページでは、Crystal Reports for Visual Studio では使用できなかったが、アップグレード バージョンで使用可能になった機能について説明します。Crystal Reports for Visual Studio の詳細については、「Crystal Reports for Visual Studio について」を参照してください。アップグレード バージョンについての詳細情報は、「アップグレード オプション」を参照してください。 |
オブジェクト モデル
このレポートをバインドするシナリオは、「CrystalReportViewer オブジェクト モデルによるレポートのバインド」を使用します。
レポートの場所
レポートはアンマネージド RAS サーバー(「Report Application Server(RAS)」を参照)に置かれます。レポートは、EnterpriseReportDocument クラスにラップされます。
Crystal サービス 概要
このレポートをバインドするシナリオは、サーバー エクスプローラの Crystal サービス サーバー ノードからアクセスするレポートに適用されます。
注 |
---|
Crystal サービスの概要については、「Crystal サービスの使用」を参照してください。 |
このセクションでは、Crystal Reports 9 に含まれる Crystal サービスの Report Application Server サブ ノードについて説明します。
[SERVERNAME]
- Crystal サービス
- Report Application Server
説明
Report Application Server サブ ノードは、アンマネージド RAS サーバーによって公開されているレポートにアクセスしてこれを表示します。
[Crystal サービス]の下の[Report Application Server]ノードから、レポートを Web フォームまたは Windows フォームにドラッグ アンド ドロップすると、EnterpriseReportDocument のインスタンスが生成されます。EnterpriseReportDocument クラスは、ラッパー クラスとして機能します。クラスの目的は、アンマネージド RAS サーバーから渡されるレポートをラップ(表示)することです。
Crystal Reports 10 ではこのシナリオは置き換えられ、レポートのバインドには次のシナリオを使用します。
Crystal サービスの機能を比較する表については、下記を参照してください。
- 「Crystal サービスを使用して CrystalReportViewer をバインドするシナリオ」
- 「Crystal サービスを使用して ReportDocument をバインドするシナリオ(VS .NET 2002 および 2003)」
「Report Application Server(RAS)」 レポートをバインドする最適な方法については、レポートのバインドのシナリオ「ReportDocument.Load() メソッドを使ったアンマネージド RAS へのバインド」で説明されています。
長所
- 簡単なアクセス:アンマネージド RAS サーバーからのレポートは、ツリー ビューで表示され、Web フォームへ簡単にドラッグできます。
短所
このモデルは、オブジェクト モデルの対話には特に有効ではありません。
- ラッパー クラスの EnterpriseReportDocument は、アンマネージド RAS サーバーとのレポートのやりとりにのみ使用され、オブジェクト モデルを備えていません。
- このバインドするシナリオは、CrystalReportViewer に含まれる、制限されたオブジェクト モデルのみを提供します。詳細については、「適切なオブジェクト モデルの選択」を参照してください。
[Crystal サービス]の下の[Report Application Server]ノードを使用する
- Crystal Reports 9 がインストールされ、正しく動作する。
- アンマネージド Report Application Server(RAS)がインストールされ、正しく動作する。
注 |
---|
この手順は、「プロジェクトの設定」で作成されたプロジェクトにのみ有効です。「プロジェクトの設定」では、この手順で必要な特定の名前空間の参照とコード設定が説明されており、この設定は、この手順を完了するために必須です。したがって、この手順を始める前にまず、「プロジェクトの設定」の手順を実行しておく必要があります。 |
Visual Studio でサーバー エクスプローラを開きます。
[Crystal サービス]、[サーバー ファイル]の順に展開します。
注 Crystal Reports 9 では、[サーバー ファイル]ノードには、ユーザーのローカル ファイル ディレクトリからのレポートではなく、RAS サーバーのレポートが表示されます。
[サーバー ファイル]ツリーでレポートを選択し、Web フォームまたは Windows フォームにドラッグします。
コード ビューに切り替え、Web フォームまたは Windows フォーム デザイナの生成コードの箇所を開きます。
注 EnterpriseReportDocument クラスは、この領域でインスタンス化と設定が行われます。
「プロジェクトの設定」で作成した ConfigureCrystalReports() メソッドでは、EnterpriseReportDocument インスタンスを CrystalReportViewer コントロールの ReportSource プロパティに割り当てます。
myCrystalReportViewer.ReportSource = enterpriseReportDocument1
crystalReportViewer.ReportSource = enterpriseReportDocument1;
レポートを表示するには、プロジェクトをビルドおよび実行してください。