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

[アーティクル]
08/09/2011

ホストコントロールをデータソースにバインドし、データソースを更新すると、その変更内容はコントロール内のデータにも反映されます。このプロセスは、主に 2 つの手順で構成されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

コントロールをデータソースにバインドする Binding オブジェクトの System.Windows.Forms.DataSourceUpdateMode.OnPropertyChanged モードを使用します。データソースの更新には 2 つのオプションがあります。
- コントロールの検証時にデータソースを更新するには、このプロパティを System.Windows.Forms.DataSourceUpdateMode.OnValidation に設定します。
- コントロールのデータバインドプロパティの値が変更されたときにデータソースを更新するには、このプロパティを System.Windows.Forms.DataSourceUpdateMode.OnPropertyChanged に設定します。
  
  注意
  
  System.Windows.Forms.DataSourceUpdateMode.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);
```