チュートリアル : キャッシュされたデータセットを使用したマスター/詳細関係の作成

[アーティクル]
02/21/2013

このチュートリアルでは、ワークシート上でのマスター/詳細リレーションシップの作成、およびソリューションをオフラインで使用することを目的とするデータのキャッシュについて説明します。

対象: このトピックの情報は、Excel 2013 と Excel 2010 のドキュメントレベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクトタイプ別の使用可能な機能」を参照してください。

このチュートリアルでは、次の作業を行う方法について説明します。

ワークシートにコントロールを追加します。
ワークシートにキャッシュするデータセットを設定する。
レコード間をスクロールするためのコードを追加する。
プロジェクトのテスト

[!メモ]

次の手順で参照している Visual Studio ユーザーインターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。これらの要素は、使用する Visual Studio のエディションとその設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

必須コンポーネント

このチュートリアルを実行するには、次のコンポーネントが必要です。

Microsoft Office Developer Tools が含まれているエディションの Visual Studio 2012。詳細については、「[Office ソリューションを開発できるようにコンピューターを構成する](bb398242\(v=vs.110\).md)」を参照してください。

Excel 2013 または Excel 2010。
Northwind SQL Server サンプルデータベースへのアクセス。このデータベースは開発用コンピューターまたはサーバーにあります。
SQL Server データベースの読み込み/書き込みアクセス許可

新規プロジェクトの作成

この手順では、Excel ブックのプロジェクトを作成します。

新しいプロジェクトを作成するには

Visual Basic または C# を使用して、My Master-Detail という名前の Excel ブックプロジェクトを作成します。[新規ドキュメントの作成] が選択されていることを確認します。詳細については、「方法: Visual Studio で Office プロジェクトを作成する」を参照してください。

新しい Excel ブックがデザイナーで開き、My Master-Detail プロジェクトがソリューションエクスプローラーに追加されます。

データソースの作成

[データソース] ウィンドウを使用して型指定されたデータセットをプロジェクトに追加します。

データソースを作成するには

[データソース] のウィンドウが表示されない場合は、これを、[ビュー]、[その他のウィンドウ] を選択する、メニューバーの [データソース] 表示されます。
[データソース構成ウィザード] を開始するには [新しいデータソースの追加] を選択します。
[データベース] をクリックし、[次へ] をクリックします。
SQL Server Northwind サンプルデータベースへのデータ接続を選択するか、または [新しい接続] をクリックして新しい接続を追加します。
接続を選択または作成したら、[次へ] をクリックします。
接続を保存するオプションがオンになっている場合はオフにし、[次へ] をクリックします。
[データベースオブジェクト] ウィンドウの [テーブル] ノードを展開します。
[Orders] テーブルと [Order Details] テーブルを選択します。
[完了] をクリックします。

[データソース] ウィンドウに 2 つのテーブルが追加されます。さらに、ソリューションエクスプローラーに表示されるプロジェクトに、型指定されたデータセットも追加されます。

ワークシートへのコントロールの追加

この手順では、1 番目のワークシートに、名前付き範囲、リストオブジェクト、および 2 つのボタンを追加します。最初に、自動的にデータソースにバインドされるように、[データソース] ウィンドウから名前付き範囲とリストオブジェクトを追加します。次に、ツールボックスからボタンを追加します。

名前付き範囲とリストオブジェクトを追加するには

[My Master-Detail.xlsx] ブックが Visual Studio のデザイナーで開いていると、表示 [Sheet1] ことを確認します。
[データソース] ウィンドウを表示し、[Orders] ノードを展開します。
[OrderID] 列を選択し、表示されるドロップダウン矢印をクリックします。
ドロップダウンリストの [NamedRange] をクリックし、[OrderID] 列をセル A2 にドラッグします。

OrderIDNamedRange という名前の NamedRange コントロールがセル A2 に作成されます。同時に、OrdersBindingSource という名前の BindingSource、テーブルアダプター、および DataSet のインスタンスがプロジェクトに追加されます。コントロールは BindingSource にバインドされ、さらにこれが DataSet インスタンスにバインドされます。
[Orders] テーブルの下にある列をスクロールダウンします。リストの一番下には、Orders テーブルの子である Order Details テーブルがあります。Orders テーブルと同じレベルにあるテーブルではなく、この [Order Details] テーブルを選択し、表示されるドロップダウン矢印をクリックします。
ドロップダウンリストの [ListObject] をクリックし、[Order Details] テーブルをセル A6 にドラッグします。
Order_DetailsListObject という名前の ListObject コントロールがセル A6 に作成され、BindingSource にバインドされます。

2 つのボタンを追加するには

ツールボックスの [コモンコントロール] タブからワークシートのセル A3 へ、Button コントロールをドラッグします。

このボタンは Button1 という名前になります。
別の Button コントロールを、ワークシートのセル B3 に追加します。

このボタンは Button2 という名前になります。

次に、文書にキャッシュされるデータセットをマーキングします。

データセットのキャッシュ

データセットをパブリックにし、CacheInDocument プロパティを設定することによって、文書にキャッシュするデータセットをマーキングします。

データセットをキャッシュするには

コンポーネントトレイの [NorthwindDataSet] を選択します。
[プロパティ] ウィンドウで、Modifiers プロパティを Public に設定します。

キャッシュを有効にする前に、データセットをパブリックにする必要があります。
CacheInDocument プロパティを True に変更します。

次の手順では、ボタンにテキストを追加し、C# でイベントハンドラーをフックするコードを追加します。

コントロールの初期化

ボタンのテキストを設定し、Startup イベント時のイベントハンドラーを追加します。

データとコントロールを初期化するには

ソリューションエクスプローラーの Sheet1.vb または Sheet1.cs を右クリックし、ショートカットメニューの [コードの表示] をクリックします。
Sheet1_Startup メソッドに次のコードを追加して、ボタンのテキストを設定します。
```
Me.Button1.Text = "<"
Me.Button2.Text = ">"
```
```
this.button1.Text = "<";
this.button2.Text = ">";
```
C# の場合のみ、ボタンクリックイベントのイベントハンドラーを Sheet1_Startup メソッドに追加します。
```
this.button1.Click += new EventHandler(button1_Click);
this.button2.Click += new EventHandler(button2_Click);
```

レコード間をスクロールするためのコードの追加

レコード間を移動するためのコードを各ボタンの Click イベントハンドラーに追加します。

レコード間をスクロールするには

Button1 の Click イベントのイベントハンドラーを追加し、レコード間を後方に移動できるように次のコードを追加します。

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Me.OrdersBindingSource.MovePrevious()
End Sub

private void button1_Click(object sender, EventArgs e)
{
    this.ordersBindingSource.MovePrevious();
}

Button2 の Click イベントのイベントハンドラーを追加し、レコード間を前方に移動できるように次のコードを追加します。

Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button2.Click

    Me.OrdersBindingSource.MoveNext()
End Sub

private void button2_Click(object sender, EventArgs e)
{
    this.ordersBindingSource.MoveNext();
}

アプリケーションのテスト

ブックをテストして、データが期待どおりに表示され、ソリューションをオフラインで使用できることを確認します。

データキャッシュをテストするには

F5 キーを押します。
名前付き範囲とリストオブジェクトに、データソースのデータが設定されていることを確認します。
ボタンをクリックして、いくつかのレコードをスクロールします。
ブックを保存し、ブックと Visual Studio を閉じます。
データベースへの接続を無効にします。データベースがサーバー上にある場合はコンピューターからネットワークケーブルを外します。また、データベースが開発用コンピューター上にある場合は SQL Server サービスを停止します。
開いている Excel は、を\bin のディレクトリ (Visual Basic の\My Master-Detail\bin または、C の\My Master-Detail\bin\debug) の [My Master-Detail.xlsx] を開きます。
いくつかのレコードをスクロールして、接続していない状態で、ワークシートが正常に動作することを確認します。
データベースに再接続します。データベースがサーバー上にある場合はコンピューターをネットワークに再接続します。また、データベースが開発用コンピューター上にある場合は SQL Server サービスを開始します。

次の手順

このチュートリアルでは、ワークシート上でのマスター/詳細リレーションシップの作成、およびデータセットのキャッシュの基本事項について説明します。次に行う作業は以下のとおりです。

ソリューションの配置。詳細については、「Office ソリューションの配置」を参照してください。

参照

概念

キャッシュされたデータ

ホスト項目とホストコントロールの概要

その他の技術情報

Office ソリューションでのコントロールへのデータのバインド

Office ソリューションにおけるデータ

次の方法で共有

チュートリアル : キャッシュされたデータセットを使用したマスター/詳細関係の作成

必須コンポーネント

新規プロジェクトの作成

新しいプロジェクトを作成するには

データソースの作成

データソースを作成するには

ワークシートへのコントロールの追加

名前付き範囲とリストオブジェクトを追加するには

2 つのボタンを追加するには

データセットのキャッシュ

データセットをキャッシュするには

コントロールの初期化

データとコントロールを初期化するには

レコード間をスクロールするためのコードの追加

レコード間をスクロールするには

アプリケーションのテスト

データキャッシュをテストするには

次の手順

参照

概念

その他の技術情報

その他のリソース

次の方法で共有

チュートリアル : キャッシュされたデータセットを使用したマスター/詳細関係の作成

必須コンポーネント

新規プロジェクトの作成

新しいプロジェクトを作成するには

データ ソースの作成

データ ソースを作成するには

ワークシートへのコントロールの追加

名前付き範囲とリスト オブジェクトを追加するには

2 つのボタンを追加するには

データセットのキャッシュ

データセットをキャッシュするには

コントロールの初期化

データとコントロールを初期化するには

レコード間をスクロールするためのコードの追加

レコード間をスクロールするには

アプリケーションのテスト

データ キャッシュをテストするには

次の手順

参照

概念

その他の技術情報

その他のリソース

データソースの作成

データソースを作成するには

名前付き範囲とリストオブジェクトを追加するには

データキャッシュをテストするには