方法 : ホストコントロールからのデータでデータソースを更新する

[アーティクル]
04/28/2010

更新 : 2008 年 7 月

対象
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。ドキュメントレベルのプロジェクト Excel 2003 Excel 2007 Word 2003 Word 2007 アプリケーションレベルのプロジェクト Excel 2007 Word 2007 詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。

ドキュメントレベルのプロジェクト

Excel 2003
Excel 2007
Word 2003
Word 2007

アプリケーションレベルのプロジェクト

Excel 2007
Word 2007

詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

ホストコントロールをデータソースにバインドし、データソースを更新すると、その変更内容はコントロール内のデータにも反映されます。

Visual Studio 2008 Service Pack 1 (SP1) 以降、アプリケーションレベルのプロジェクトのデータにホストコントロールをバインドできるようになりました。SP1 をインストールしていない場合、ホストコントロールはドキュメントレベルのプロジェクトでのみ使用できます。

このプロセスは、主に 2 つの手順で構成されます。

コントロールで変更されたデータを使用して、インメモリデータソースを更新します。一般に、インメモリデータソースは DataSet、DataTable、またはその他のデータオブジェクトです。
インメモリデータソースで変更されたデータを使用して、データベースを更新します。これは、データソースが SQL Server や Microsoft Office Access データベースなどのバックエンドデータベースに接続されている場合にのみ有効です。

ホストコントロールとデータバインディングの詳細については、「ホスト項目とホストコントロールの概要」および「コントロールへのデータのバインド」を参照してください。

インメモリデータソースの更新

既定では、単純データバインディングを有効にしているホストコントロール (Word 文書のコンテンツコントロールや Excel ワークシートの名前付き範囲コントロールなど) は、データの変更内容をインメモリデータソースに保存しません。つまり、エンドユーザーがホストコントロールの値に変更を加えてからコントロールの外に移動すると、コントロールの新しい値は自動的にはデータソースに保存されません。

データソースにデータを保存するには、実行時に特定のイベントに応答してデータソースを更新するコードを記述します。または、コントロールの値が変更されたときに自動的にデータソースを更新するようにコントロールを構成することもできます。

インメモリデータソースに ListObject の変更を保存する必要はありません。ListObject コントロールをデータにバインドすると、ListObject コントロールは変更内容を自動的にインメモリデータソースに保存します。追加のコードを記述する必要はありません。

実行時にインメモリデータソースを更新するには

コントロールをデータソースにバインドする Binding オブジェクトの WriteValue メソッドを呼び出します。

Excel ワークシートの NamedRange コントロールに加えられた変更をデータソースに保存する例を次に示します。この例は、namedRange1 という名前の NamedRange コントロールで Value2 プロパティがデータソースのフィールドにバインドされていることを前提としています。
```
Me.NamedRange1.DataBindings("Value2").WriteValue()
```
```
this.namedRange1.DataBindings["Value2"].WriteValue();
```

インメモリデータソースの自動更新

インメモリデータソースを自動的に更新するように、コントロールを構成することもできます。ドキュメントレベルのプロジェクトでこれを行うには、コードまたはデザイナを使用します。アプリケーションレベルのプロジェクトでは、コードを使用する必要があります。

コードを使用してインメモリデータソースを自動的に更新するようにコントロールを設定するには

コントロールをデータソースにバインドする Binding オブジェクトの DataSourceUpdateMode プロパティを使用します。データソースの更新には 2 つのオプションがあります。

コントロールの検証時にデータソースを更新するには、このプロパティを OnValidation に設定します。

コントロールのデータバインドプロパティの値が変更されたときにデータソースを更新するには、このプロパティを OnPropertyChanged に設定します。

メモ :
OnPropertyChanged オプションは、Word ホストコントロールには適用されません。Word では文書変更やコントロール変更の通知は提供されないためです。ただし、Word 文書上の Windows フォームコントロールには、このオプションを使用できます。

コントロールの値を変更するときに自動的にデータソースを更新するように NamedRange コントロールを構成する例を次に示します。この例は、namedRange1 という名前の NamedRange コントロールで Value2 プロパティがデータソースのフィールドにバインドされていることを前提としています。

Me.NamedRange1.DataBindings("Value2").DataSourceUpdateMode = _
    DataSourceUpdateMode.OnPropertyChanged

this.namedRange1.DataBindings["Value2"].DataSourceUpdateMode = 
    DataSourceUpdateMode.OnPropertyChanged;

デザイナを使用してインメモリデータソースを自動的に更新するようにコントロールを設定するには

Visual Studio のデザイナで、Word 文書または Excel ブックを開きます。
データソースの自動更新を行うコントロールをクリックします。
[プロパティ] ウィンドウで (DataBindings) プロパティを展開します。
(Advanced) プロパティの横にある省略記号ボタン () をクリックします。

[フォーマットと詳細バインド] ダイアログボックスで、[データソース更新モード] ドロップダウンリストをクリックし、次の値を選択します。

コントロールの検証時にデータソースを更新するには、[OnValidation] を選択します。

コントロールのデータバインドプロパティの値が変更されたときにデータソースを更新するには、[OnPropertyChanged] を選択します。

メモ :
[OnPropertyChanged] オプションは、Word ホストコントロールには適用されません。Word では文書変更やコントロール変更の通知は提供されないためです。ただし、Word 文書上の Windows フォームコントロールには、このオプションを使用できます。

[フォーマットと詳細バインド] ダイアログボックスを閉じます。

データベースの更新

インメモリデータソースがデータベースに関連付けられている場合、データソースへの変更内容を使用して、データベースを更新する必要があります。データベース更新の詳細については、「データ保存の概要」および「方法 : TableAdapter を使用してデータを更新する」を参照してください。

データベースを更新するには

コントロールの BindingSource の EndEdit メソッドを呼び出します。

デザイン時に文書またはブックにデータバインドコントロールを追加すると、BindingSource が自動的に生成されます。BindingSource によって、コントロールはプロジェクト内の型指定されたデータセットに接続されます。詳細については、「BindingSource コンポーネントの概要」を参照してください。

次のコード例は、プロジェクトに customersBindingSource という名前の BindingSource が含まれていることを前提としています。
```
Me.CustomersBindingSource.EndEdit()
```
```
this.customersBindingSource.EndEdit();
```
プロジェクトで生成された TableAdapter の Update メソッドを呼び出します。

デザイン時に文書またはブックにデータバインドコントロールを追加すると、TableAdapter が自動的に生成されます。TableAdapter によって、プロジェクト内の型指定されたデータセットはデータベースに接続されます。詳細については、「TableAdapter の概要」を参照してください。

次のコード例は、Northwind データベースの Customers テーブルに接続し、プロジェクトには customersTableAdapter という名前の TableAdapter と northwindDataSet という名前の型指定されたデータセットが含まれていることを前提としています。
```
Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
```
```
this.customersTableAdapter.Update(this.northwindDataSet.Customers);
```