Microsoft Report ViewerおよびOracle Instant Clientレポートを使用した.Netアプリケーションのポータブル配布

多くの場合、インストーラーの作成を拒否し、ファイルフォルダーをターゲットコンピューターにコピーしてアプリケーションを配布することを拒否する必要性または要望があります。 Report Viewerレポートを使用して.Netアプリケーション用のポータブル配布キットを作成する方法、またはOracleデータベースにアクセスするためにクライアントとドライバーをポータブルにコピーする方法に興味がある場合は、catを使用してください。 私はすべてを詳細に説明しようとします。

実用的な部分として、Supermagトレーディングシステム（実際にはOracleデータベースを使用）のレポートを表示するアプリケーションの作成を検討します。

Oracleクライアントのポータブル配布の利点の1つは、その標準インストールが快適な体験ではないことです。 また、レポートビューアーもインストールする場合、複数のマシンでのインストールプロセスは面倒なタスクになるリスクがあります。 もちろん、代替手段としてClickOnceを使用できますが、ClickOnceを使用して配布する場合、この例のようにライブラリフォルダーをコピーすることもできます。

Oracleへのポータブルアクセスを備えたデスクトップアプリケーションに不可欠なライブラリ

Oracle Instant Clientをダウンロードする必要があります。 ローカライズされたアプリケーションを使用する場合、サイズは約100Mbですが、基本パッケージを使用する方が適切ですが、「軽い」30メガバイトとは異なり、キリル文字を使用することが保証されます。

アーカイブを展開し、そこから2つのファイルを取得します。

oci.dll （Oracle Call Interfaceの略）;
orannzsbb11.dllまたはorannzsbb12.dll （バージョン12を使用する場合）。

3番目のファイルも必要です。

基本バージョンを使用した場合、 oraociei11.dllまたはoraociei12.dll （バージョン12でも同様 ）になります。
ライトバージョンを使用した場合-oraociicus11.dllまたはoraociicus12.dll （バージョン12の2番目のファイルが誰にでも明らかであることは言及しません）。

また、Oracle Data Provider-ODP.NET（XCopyバージョンを使用することをお勧めします。サイズが小さい方）も必要です。2つのファイルを解凍して検索します。

Oracle.DataAccess.dll ;
OraOps11w.dllまたはOraOps12w.dll （このファイルはOracle.DataAccess.dllがOracle Instant Clientファイルを操作するために必要です。.Net2.0と.Net 4.0の両方で同じです）。

バージョン12を使用する場合は、次のリンクから1つのODAC（Oracle Data Access Components）ファイルでOracle Instant ClientとODPの両方をダウンロードできます。

ポータブルレポートビューアーアプリケーションの必須ライブラリ

レポートビューアーのポータブルな配布物として、バージョン2010を取り上げましょう。

私はバージョン2013をポータブル配布用のバージョンとは見なしませんでした。 Microsoft.ReportViewer.ProcessingobjectModel.dllが見つからないことがわかった後、「テンプレートブレーク」が発生し、2010年のレポートは非​​常に良好であると判断しました。 2013バージョンのポータブルディストリビューションの作成方法をご存知の場合は、コメントをお待ちしています。 競争を発表することもできますが、これは不運です-賞品はありません。

Microsoft Report Viewer Redistributable 2010をダウンロードし、exeファイルをアーカイブとして解凍します。
解凍されたファイルの中には、reportviewer_redist2010core.cabがあります。
「入れ子人形」を続けて、このファイルを順番に展開します。
ファイルを見つけて、次のように名前を変更します。

FL_Microsoft_ReportViewer_Common_dll_117718_117718_x86_ln.3643236F_FC70_11D3_A536_0090278A1BB8
名前をMicrosoft.ReportViewer.Common.dllに変更します

FL_Microsoft_ReportViewer_Processingobject_125592_125592_x86_ln.3643236F_FC70_11D3_A536_0090278A1BB8
名前をMicrosoft.ReportViewer.ProcessingobjectModel.dllに変更します

FL_Microsoft_ReportViewer_WebForms_dll_117720_117720_x86_ln.3643236F_FC70_11D3_A536_0090278A1BB8
名前をMicrosoft.ReportViewer.WebForms.dllに変更します

FL_Microsoft_ReportViewer_WinForms_dll_117722_117722_x86_ln.3643236F_FC70_11D3_A536_0090278A1BB8
名前をMicrosoft.ReportViewer.WinForms.dllに変更します

開発者のコ​​ンピューターにOracle ClientとReport Viewerがインストールされている場合（インストールする必要があります）、これらのファイルへのリンクを設定することもできますが、exeでフォルダーに（プロジェクトのDebugフォルダーとReleaseフォルダーに）コピーするだけです。 ただし、Oracle.DataAccess.dllはプロジェクトフォルダに配置し、「ローカルにコピー」プロパティを2つのコピーオプションのいずれかに設定する必要があります。

ポータブル配布の恐怖がそれほど大きくないように、デスクトップ.N​​etアプリケーションのライブラリ検索アルゴリズムについて簡単に説明します。

dll検索を開始する前に、システムは、dllが既にメモリにロードされているかどうか、およびdllがすでに既知のdllのリストにあるかどうかを確認します（レジストリのHKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ Control \ Session Manager \ KnownDLLsのリストを見てみてください）。

dll検索アルゴリズムはいくつかの要因（SafeDllSearchModeモードが設定されているかどうかなど）に依存しますが、ほぼ同じです（この例ではSafeDllSearchModeがオフになっています）。

1.アプリケーションの起動元のディレクトリ。
2.現在のディレクトリ。
3.システムディレクトリ。 GetSystemDirectory関数を使用して、このディレクトリへのパスを取得できます。
4. 16ビットシステムディレクトリ。
5. Windowsディレクトリ。 GetWindowsDirectory関数を使用できます。
6. PATHシステム変数で指定されているフォルダー。

PATHシステム変数とは何で、どこにあるのか、次のスクリーンショットを視覚的に確認してください。



それでは、実際の部分に移りましょう。

WPFアプリケーション（およびレイアウトエディターとしての従来のフォームよりもXAMLの方が望ましい）では、レポートビューアーコンポーネントはWindowsFormsHostコントロールを使用して追加されます。

<WindowsFormsHost HorizontalAlignment="Stretch" VerticalAlignment="Stretch" Margin="0,0,0,0" Name="windowsFormsHost1"> <rv:ReportViewer x:Name="_reportViewer"/> </WindowsFormsHost> 

この例が役に立たないように、ドキュメントの履歴からデータを受け取ります。
レポートに必要なデータを保存するには、クラスを作成します。

  public class ReportDataSM { public DateTime EventTime { get; set; } public string Doc { get; set; } public string UserName { get; set; } public string NewState { get; set; } } 

これで、レポートの外観用のテンプレートファイルを作成できます（開発者のコ​​ンピューターのビジュアルエディターでは、Visual Studioをインストールするときに、Microsoft SQL Serverデータツールアイテムを選択する必要があります）。

レポートファイルをプロジェクトに追加します（レポート）。 「ローカルにコピー」プロパティの値を「新しい場合にコピー」に設定します。 次に、作成したばかりのレポートファイルを開き、[データソース]タブに移動します。 [新しいデータソースの追加]をクリックし、[オブジェクト]タイプを選択します。オブジェクトのリストでプロジェクトを開き、選択したクラスReportDataSMを見つけます。



次に、データを含む行を表示するには、レポートにテーブルを追加します。 データセットのプロパティをクエリに追加する場合、データソースを選択し、名前を付けます（例ではDataSet1）。



このデータソースは、DataSetNameプロパティのテーブルタブで指定されます。 rdlcファイルは、ビジュアルエディターだけでなく、XMLエディターを使用して編集することもできます（この方法では、古い不要なデータを削除するのに便利です）。

配列のデータから列の値を設定します（線をクリックするのは簡単で直感的です。詳細は説明しません）。

コードを検討する

インターフェイスの凍結は非常に悪い習慣なので、データサンプリングは別のストリームで開始します。 データストレージには、ReportDataSMクラスの競合する汎用（汎用）コレクションを使用します。 変数宣言に追加します（クラスの先頭）：

 ConcurrentBag<ReportDataSM> list4R; 

コードのどこかで初期化した後：

 list4R = new ConcurrentBag<ReportDataSM>(); 

インターフェイスをブロックせずにデータを受信することにしたので、メソッドを非同期に呼び出すデリゲートが必要です。

 delegate void MyGetDataDelegate(string s); 

この例では、デリゲートはパラメーターとして1つの文字列値を取ります。
パラメーターは、変更履歴に関するデータを受信するドキュメントの識別子になります。
デリゲート実装であるメソッドは、getDataMethodと呼ばれるメソッドです。
データを取得する方法を実装するための簡略化されたコードを提供します（エラーを処理することなく）。

  void getDataMethod(string docid){ DataSet dataset = new DataSet(); string oradb = "Data Source=" + "DATABASENAME" + ";User Id=" + "typeusernamehere" + ";Password=" + "password123" + ";"; //  ,        ,      Oracle //   TNSNAMES.ORA  ,     . using (OracleConnection conn = new OracleConnection(oradb)) { if (conn.State != ConnectionState.Open) conn.Open(); string sqltext = "select SMDocLog.EVENTTIME, SMDocLog.ID, SMDocLog.USERNAME, NVL(SSDocStates.DOCSTATENAME,' ') as NEWSTATE"; sqltext = sqltext + " from SMDocLog LEFT JOIN SSDocStates"; sqltext = sqltext + " ON SMDocLog.DOCTYPE=SSDocStates.DOCTYPE and SMDocLog.NEWSTATE=SSDocStates.DOCSTATE"; sqltext = sqltext + " WHERE ID='" + docid + "'"; sqltext = sqltext + " ORDER BY EVENTTIME DESC"; using (OracleCommand cmd = new OracleCommand()) { cmd.Connection = conn; cmd.CommandText = sqltext; cmd.CommandType = CommandType.Text; using (OracleDataAdapter adapterO = new OracleDataAdapter(cmd)) { using (DataSet ds = new DataSet()) { adapterO.Fill(ds); //    ,        foreach (DataRow dr in ds.Tables[0].Rows) { ReportDataSM rd = new ReportDataSM(); rd.EventTime = Convert.ToDateTime(dr["EVENTTIME"]); rd.UserName = dr["USERNAME"].ToString(); rd.Doc = dr["ID"].ToString(); rd.NewState = dr["NEWSTATE"].ToString(); list4R.Add(rd); } } // end using DataSet } // end using OracleDataAdapter } // end using OracleCommand } } 

このメソッドを非同期で呼び出します：

  MyGetDataDelegate dlgt = new MyGetDataDelegate(this.getDataMethod); IAsyncResult ar = dlgt.BeginInvoke(txtDocN.Text, new AsyncCallback(CompletedCallback), null); 

パラメーターとして渡されるCompletedCallbackメソッドに注意してください。
その実装は、呼び出されたメソッドの完了後に他のメソッドを実行するために必要です。 この場合、データを抽出した後、このデータをレポートにバインドし、インターフェースを更新する必要があります。

  void UpdateUserInterface() { _reportViewer.Reset(); ReportDataSource reportDataSource= new ReportDataSource("DataSet1", list4R); //            _reportViewer.LocalReport.ReportPath = "ReportSM.rdlc"; _reportViewer.LocalReport.DataSources.Add(reportDataSource); _reportViewer.RefreshReport(); } 

しかし、アプリケーションストリームからのみインターフェイスを更新できるという点で問題があります。
これを行うには、ディスパッチャスレッドからアプリケーションインターフェイス更新メソッドを呼び出します。 つまり、CompletedCallbackメソッドの内容は次のようになります。

 void CompletedCallback(IAsyncResult result) { Dispatcher.BeginInvoke(System.Windows.Threading.DispatcherPriority.Normal, new NoArgDelegate(UpdateUserInterface)); } 

繰り返しますが、メソッドを非同期的に呼び出すには、デリゲートが必要でしたが、今回はパラメータを受け入れません。 コードの先頭に追加します。

 private delegate void NoArgDelegate(); 

このアプリケーションのようなものを取得する必要があります。



更新： GitHubプロジェクトへのリンク （NuGetパッケージマネージャーからインストールされたOracle.ManagedDataAccessを使用）