チュートリアル : サーバー上のブックからのキャッシュされたデータの取得
このチュートリアルでは、ServerDocument クラスを使用して、Microsoft Office Excel ブックにキャッシュされたデータセットから、Excel を起動することなくデータを取得する方法について説明します。 このチュートリアルでは、「方法 : サーバー上のブックからキャッシュされたデータを取得する」に記載されているコード例を使用する場合の詳細な手順について説明します。
対象: このトピックの情報は、Excel 2007 と Excel 2010 のドキュメント レベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクト タイプ別の使用可能な機能」を参照してください。
このチュートリアルでは、次の作業について説明します。
AdventureWorksLT データベースのデータを格納するデータセットを定義する。
Excel ブック プロジェクトおよびコンソール アプリケーション プロジェクトにデータセットのインスタンスを作成する。
ブックのデータセットにバインドされた ListObject を作成し、ブックが開かれたときに ListObject にデータを設定する。
ブックのデータセットをデータ キャッシュに追加する。
Excel を起動することなく、キャッシュされたデータセットからコンソール アプリケーションのデータセットにデータを読み込む。
このチュートリアルでは開発用コンピューターでコードを実行することを想定していますが、このチュートリアルに掲載されているコードは、Excel がインストールされていないサーバー上でも実行できます。
注意
次の手順で参照している Visual Studio ユーザー インターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。 これらの要素は、使用する Visual Studio のエディションとその設定によって決まります。 詳細については、「設定の操作」を参照してください。
必須コンポーネント
このチュートリアルを実行するには、次のコンポーネントが必要です。
-
Microsoft Office 開発者ツールを含むエディションの Visual Studio 2010。 詳細については、「[Office ソリューションを開発できるようにコンピューターを構成する](bb398242\(v=vs.100\).md)」を参照してください。
Excel 2007 または Excel 2010
AdventureWorksLT サンプル データベースがアタッチされた、Microsoft SQL Server または Microsoft SQL Server Express の実行中のインスタンスへのアクセス。 AdventureWorksLT データベースは、CodePlex の Web サイトからダウンロードできます。 データベースを関連付ける方法の詳細については、以下のトピックを参照してください。
SQL Server Management Studio または SQL Server Management Studio Express を使用してデータベースを関連付ける方法については、「データベースをアタッチする方法 (SQL Server Management Studio)」を参照してください。
コマンド ラインを使用してデータベースを関連付ける方法については、「データベース ファイルを SQL Server Express にアタッチする方法」を参照してください。
データセットを定義するクラス ライブラリ プロジェクトの作成
Excel ブック プロジェクトとコンソール アプリケーションとで同じデータセットを使用するには、これらのプロジェクトの両方から参照される別個のアセンブリ内にデータセットを定義する必要があります。 このチュートリアルでは、データセットをクラス ライブラリ プロジェクトに定義します。
クラス ライブラリ プロジェクトを作成するには
Visual Studio を起動します。
[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
テンプレート ペインで、[Visual C#] または [Visual Basic] を展開し、[Windows] をクリックします。
プロジェクト テンプレートの一覧で、[クラス ライブラリ] を選択します。
[プロジェクト名] ボックスに「AdventureWorksDataSet」と入力します。
[参照] をクリックします。%UserProfile%\My Documents フォルダー (Windows XP 以前のバージョンの場合) または %UserProfile%\Documents (Windows Vista の場合) フォルダーに移動し、[フォルダーの選択] をクリックします。
[新しいプロジェクト] ダイアログ ボックスで、[ソリューションのディレクトリを作成] チェック ボックスがオフになっていることを確認します。
[OK] をクリックします。
Visual Studio によって AdventureWorksDataSet プロジェクトがソリューション エクスプローラーに追加され、Class1.cs コード ファイルまたは Class1.vb コード ファイルが開かれます。
ソリューション エクスプローラーで、[Class1.cs] または [Class1.vb] を右クリックし、[削除] をクリックします。 このファイルは、このチュートリアルには必要ありません。
クラス ライブラリ プロジェクトへのデータセットの定義
SQL Server 2005 用 AdventureWorksLT データベースのデータを格納する型指定されたデータセットを定義します。 このチュートリアルの後半で、Excel ブック プロジェクトおよびコンソール アプリケーション プロジェクトからこのデータセットを参照します。
このデータセットは、AdventureWorksLT データベースの Product テーブルのデータを表す型指定されたデータセットです。 型指定されたデータセットの詳細については、「Visual Studio でのデータセットの操作」を参照してください。
クラス ライブラリ プロジェクトに型指定されたデータセットを定義するには
ソリューション エクスプローラーで [AdventureWorksDataSet] プロジェクトをクリックします。
[データ] メニューの [新しいデータ ソースの追加] をクリックします。
データ ソース構成ウィザードが開きます。
[データベース] をクリックし、[次へ] をクリックします。
AdventureWorksLT データベースへの接続が既に設定されている場合は、その接続を選択し、[次へ] をクリックします。
それ以外の場合は、[新しい接続] をクリックし、[接続の追加] ダイアログ ボックスを使用して新しい接続を作成します。 詳細については、「方法 : データベース内のデータに接続する」を参照してください。
[アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックしますSave the Connection String to the Application Configuration FileNext。
[データベース オブジェクトの選択] ページで、[テーブル] を展開し、[Product (SalesLT)] を選択します。
[完了] をクリックします。
AdventureWorksLTDataSet.xsd ファイルが AdventureWorksDataSet プロジェクトに追加されます。 このファイルでは、次の項目を定義します。
AdventureWorksLTDataSet という名前の型指定されたデータセット。 このデータセットは、AdventureWorksLT データベースの Product テーブルの内容を表します。
ProductTableAdapter という名前の TableAdapter。 TableAdapter は、AdventureWorksLTDataSet のデータを読み書きするために使用します。 詳細については、「TableAdapter の概要」を参照してください。
これらのオブジェクトはどちらもこのチュートリアルの後半で使用します。
ソリューション エクスプローラーで、[AdventureWorksDataSet] を右クリックし、[ビルド] をクリックします。
プロジェクトがエラーを発生させずにビルドすることを確認します。
Excel ブック プロジェクトの作成
データとのインターフェイス用の Excel ブック プロジェクトを作成します。 このチュートリアルの後半では、データを表示する ListObject を作成し、データセットのインスタンスをブック内のデータ キャッシュに追加します。
Excel ブック プロジェクトを作成するには
ソリューション エクスプローラーで、[AdventureWorksDataSet] ソリューションを右クリックします。[追加] をポイントし、[新しいプロジェクト] をクリックします。
テンプレート ペインで、[Visual C#] または [Visual Basic] を展開し、[Office] を展開します。
展開された [Office] ノードの下で、[2007] または [2010] ノードを選択します。
プロジェクト テンプレートの一覧で、Excel ブック プロジェクトを選択します。
[プロジェクト名] ボックスに「AdventureWorksReport」と入力します。 場所は変更しないでください。
[OK] をクリックします。
Visual Studio Tools for Office プロジェクト ウィザードが開きます。
[新規ドキュメントの作成] が選択されていることを確認し、[OK] をクリックします。
Visual Studio によって、デザイナーで AdventureWorksReport ブックが開かれ、ソリューション エクスプローラーに AdventureWorksReport プロジェクトが追加されます。
Excel ブック プロジェクトのデータ ソースへのデータセットの追加
Excel ブックにデータセットを表示するには、その前に Excel ブック プロジェクトのデータ ソースにデータセットを追加する必要があります。
Excel ブック プロジェクトのデータ ソースにデータセットを追加するには
ソリューション エクスプローラーで、[AdventureWorksReport] プロジェクトの下の [Sheet1.cs] または [Sheet1.vb] をダブルクリックします。
ブックがデザイナーで開かれます。
[データ] メニューの [新しいデータ ソースの追加] をクリックします。
データ ソース構成ウィザードが開きます。
[オブジェクト] をクリックし、[次へ] をクリックします。
[バインド先のオブジェクトを選択します] ページで、[参照の追加] をクリックします。
[プロジェクト] タブで、[AdventureWorksDataSet] をクリックし、[OK] をクリックします。
[AdventureWorksDataSet] アセンブリの [AdventureWorksDataSet] 名前空間の下にある [AdventureWorksLTDataSet] をクリックし、[完了] をクリックします。
[データ ソース] ウィンドウが開き、AdventureWorksLTDataSet がデータ ソースの一覧に追加されます。
データセットのインスタンスにバインドされた ListObject の作成
データセットをブックに表示するには、データセットのインスタンスにバインドされた ListObject を作成します。 コントロールのデータへのバインドの詳細については、「Office ソリューションでのコントロールへのデータのバインド」を参照してください。
データセットのインスタンスにバインドされた ListObject を作成するには
[データ ソース] ウィンドウで、[AdventureWorksDataSet] の下にある [AdventureWorksLTDataSet] ノードを展開します。
[Product] ノードを選択し、表示されるドロップダウン矢印をクリックします。ドロップダウン リストで [ListObject] を選択します。
ドロップダウン矢印が表示されない場合は、デザイナーでブックが開かれていることを確認します。
Product テーブルをセル A1 にドラッグします。
productListObject という名前の ListObject コントロールが、セル A1 を始点にワークシートに作成されます。 同時に、adventureWorksLTDataSet という名前のデータセット オブジェクトと、productBindingSource という名前の BindingSource がプロジェクトに追加されます。 ListObject が BindingSource にバインドされ、さらにこれがデータセット オブジェクトにバインドされます。
データ キャッシュへのデータセットの追加
Excel ブック プロジェクトの外部のコードからブック内のデータセットにアクセスできるようにするには、データセットをデータ キャッシュに追加する必要があります。 データ キャッシュの詳細については、「ドキュメント レベルのカスタマイズのキャッシュ データ」および「キャッシュされたデータ」を参照してください。
データ キャッシュにデータセットを追加するには
デザイナーで、[adventureWorksLTDataSet] をクリックします。
[プロパティ] ウィンドウで、[Modifiers] プロパティを [Public] に設定します。
[CacheInDocument] プロパティを [True] に設定します。
ブック内のデータセットの初期化
コンソール アプリケーションを使用してキャッシュされたデータセットからデータを取得するには、その前にキャッシュされたデータセットにデータを設定する必要があります。
ブック内のデータセットを初期化するには
ソリューション エクスプローラーで Sheet1.cs ファイルまたは Sheet1.vb ファイルを右クリックし、[コードの表示] をクリックします。
Sheet1_Startup イベント ハンドラーを次のコードで置き換えます。 このコードでは、AdventureWorksDataSet プロジェクトに定義されている ProductTableAdapter クラスのインスタンスを使用して、キャッシュされたデータセットが現在空である場合にデータを設定します。
Private ProductTableAdapter As New _ AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter() Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup If Me.NeedsFill("AdventureWorksLTDataSet") Then Me.ProductTableAdapter.Fill(Me.AdventureWorksLTDataSet.Product) End If End Sub
private AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter productTableAdapter = new AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter(); private void Sheet1_Startup(object sender, System.EventArgs e) { if (this.NeedsFill("adventureWorksLTDataSet")) { this.productTableAdapter.Fill(this.adventureWorksLTDataSet.Product); } }
チェックポイント
Excel ブック プロジェクトをビルドして実行して、エラーが発生することなくコンパイルおよび実行されることを確認します。 また、この操作では、キャッシュされたデータセットにデータを設定し、データをブックに保存します。
プロジェクトをビルドして実行するには
ソリューション エクスプローラーで、[AdventureWorksReport] プロジェクトを右クリックします。[デバッグ] を選択し、[新しいインスタンスを開始] をクリックします。
プロジェクトがビルドされ、ブックが Excel で開かれます。 次の点を確認します。
ListObject にデータが格納されている。
ListObject の最初の行の ListPrice 列の値が 1431.5 である。 このチュートリアルの後半で、コンソール アプリケーションを使用して ListPrice 列の値を変更します。
ブックを保存します。 ブックのファイル名または場所は変更しないでください。
Excel を終了します。
コンソール アプリケーション プロジェクトの作成
ブックのキャッシュされたデータセット内のデータを変更するコンソール アプリケーション プロジェクトを作成します。
コンソール アプリケーション プロジェクトを作成するには
ソリューション エクスプローラーで、[AdventureWorksDataSet] ソリューションを右クリックします。[追加] をポイントし、[新しいプロジェクト] をクリックします。
[プロジェクトの種類] ペインで、[Visual C#] または [Visual Basic] を展開し、[Windows] をクリックします。
[テンプレート] ペインで [コンソール アプリケーション] を選択します。
[プロジェクト名] に「DataReader」と入力します。 場所は変更しないでください。
[OK] をクリックします。
Visual Studio によって DataReader プロジェクトがソリューション エクスプローラーに追加され、Program.cs コード ファイルまたは Module1.vb コード ファイルが開きます。
コンソール アプリケーションによるキャッシュされたデータセットからのデータの取得
データをローカル AdventureWorksLTDataSet オブジェクトに読み込むには、コンソール アプリケーションで ServerDocument クラスを使用します。 キャッシュされたデータセットのデータを使用してローカル データセットが初期化されていることを確認するために、ローカル データセットの行数がアプリケーションによって表示されます。
キャッシュされたデータセットからデータを取得するには
ソリューション エクスプローラーで、[DataReader] プロジェクトを右クリックし、[参照の追加] をクリックします。
[.NET] タブで、[Microsoft.VisualStudio.Tools.Applications.ServerDocument] (DataReader プロジェクトが .NET Framework 4 を対象としている場合) または [Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0] (DataReader プロジェクトが .NET Framework 3.5 を対象としている場合) を選択します。
[OK] をクリックします。
ソリューション エクスプローラーで、[DataReader] プロジェクトを右クリックし、[参照の追加] をクリックします。
[プロジェクト] タブで、[AdventureWorksDataSet] を選択し、[OK] をクリックします。
コード エディターで Program.cs ファイルまたは Module1.vb ファイルを開きます。
コード ファイルの先頭に次の using ステートメント (C# の場合) または Imports ステートメント (Visual Basic の場合) を追加します。
Imports Microsoft.VisualStudio.Tools.Applications
using Microsoft.VisualStudio.Tools.Applications;
Main メソッドに次のコードを追加します。 このコードは、次のオブジェクトを宣言します。
AdventureWorksDataSet プロジェクトに定義されている AdventureWorksLTDataSet 型のインスタンス
AdventureWorksReport プロジェクトのビルド フォルダー内の AdventureWorksReport ブックへのパス
ブックのデータ キャッシュにアクセスするための ServerDocument オブジェクト
注意
次のコードでは、保存されたブックにファイル拡張子として.xlsx が使用されていると想定しています。 プロジェクトのブックで異なるファイル拡張子を使用している場合は、必要に応じてパスを変更してください。
Dim productDataSet As New AdventureWorksDataSet.AdventureWorksLTDataSet() Dim workbookPath As String = System.Environment.GetFolderPath( _ Environment.SpecialFolder.MyDocuments) & _ "\AdventureWorksReport\bin\Debug\AdventureWorksReport.xlsx" Dim serverDocument1 As ServerDocument = Nothing
AdventureWorksDataSet.AdventureWorksLTDataSet productDataSet = new AdventureWorksDataSet.AdventureWorksLTDataSet(); string workbookPath = System.Environment.GetFolderPath( Environment.SpecialFolder.MyDocuments) + @"\AdventureWorksReport\bin\Debug\AdventureWorksReport.xlsx"; ServerDocument serverDocument1 = null;
前の手順で追加したコードの後で、次のコードを Main メソッドに追加します。 このコードは次のタスクを実行します。
ServerDocument クラスの CachedData プロパティを使用して、ブックのキャッシュされたデータセットにアクセスします。
キャッシュされたデータセットからローカル データセットにデータを読み込みます。
データが格納されていることを示すために、ローカル データセットの行数を表示します。
Try serverDocument1 = New ServerDocument(workbookPath) Dim dataHostItem1 As CachedDataHostItem = _ serverDocument1.CachedData.HostItems("AdventureWorksReport.Sheet1") Dim dataItem1 As CachedDataItem = dataHostItem1.CachedData("AdventureWorksLTDataSet") If dataItem1 IsNot Nothing Then Console.WriteLine("Before reading data from the cache dataset, the local dataset has " & _ "{0} rows.", productDataSet.Product.Rows.Count.ToString()) ' Read the cached data from the worksheet dataset into the local dataset. Dim schemaReader As New System.IO.StringReader(dataItem1.Schema) Dim xmlReader As New System.IO.StringReader(dataItem1.Xml) productDataSet.ReadXmlSchema(schemaReader) productDataSet.ReadXml(xmlReader) Console.WriteLine("After reading data from the cache dataset, the local dataset has " & _ "{0} rows.", productDataSet.Product.Rows.Count.ToString()) Else Console.WriteLine("The data object is not found in the data cache.") End If Catch ex As System.IO.FileNotFoundException Console.WriteLine("The specified workbook does not exist.") Catch ex As System.Xml.XmlException Console.WriteLine("The data object has invalid XML information.") Finally If Not (serverDocument1 Is Nothing) Then serverDocument1.Close() End If Console.WriteLine(vbLf & vbLf & "Press Enter to close the application.") Console.ReadLine() End Try
try { serverDocument1 = new ServerDocument(workbookPath); CachedDataHostItem dataHostItem1 = serverDocument1.CachedData.HostItems["AdventureWorksReport.Sheet1"]; CachedDataItem dataItem1 = dataHostItem1.CachedData["adventureWorksLTDataSet"]; if (dataItem1 != null) { Console.WriteLine("Before reading data from the cache dataset, the local dataset has " + "{0} rows.", productDataSet.Product.Rows.Count.ToString()); // Read the cached data from the worksheet dataset into the local dataset. System.IO.StringReader schemaReader = new System.IO.StringReader(dataItem1.Schema); System.IO.StringReader xmlReader = new System.IO.StringReader(dataItem1.Xml); productDataSet.ReadXmlSchema(schemaReader); productDataSet.ReadXml(xmlReader); Console.WriteLine("After reading data from the cache dataset, the local dataset has " + "{0} rows.", productDataSet.Product.Rows.Count.ToString()); } else { Console.WriteLine("The data object is not found in the data cache."); } } catch (System.IO.FileNotFoundException) { Console.WriteLine("The specified workbook does not exist."); } catch (System.Xml.XmlException) { Console.WriteLine("The data object has invalid XML information."); } finally { if (serverDocument1 != null) { serverDocument1.Close(); } Console.WriteLine("\n\nPress Enter to close the application."); Console.ReadLine(); }
[ビルド] メニューの [DataReader のビルド] をクリックします。
プロジェクトのテスト
コンソール アプリケーションを実行すると、ローカル データセットの行数が表示されます。
ブックをテストするには
ソリューション エクスプローラーで、[DataReader] プロジェクトを右クリックします。[デバッグ] をポイントし、[新しいインスタンスを開始] をクリックします。
ローカル データセットの行数が 295 行であると報告されることを確認します。
Enter キーを押してアプリケーションを閉じます。
次の手順
キャッシュされたデータの操作については、以下のトピックを参照してください。
キャッシュされたデータセット内のデータを Excel を起動することなく初期化する。 詳細については、「チュートリアル : サーバー上のブックへのデータの挿入」を参照してください。
キャッシュされたデータセット内のデータを Excel を起動することなく変更する。 詳細については、「チュートリアル : サーバー上のブックにキャッシュされたデータの変更」を参照してください。
参照
処理手順
方法 : サーバー上のブックからキャッシュされたデータを取得する
チュートリアル : サーバー上のブックにキャッシュされたデータの変更