チュートリアル : DataRepeater コントロールでのデータの表示 (Visual Studio)

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

このチュートリアルでは、DataRepeater コントロールにバインドされたデータを表示する基本的なシナリオ全体を示します。

[必須コンポーネント]

このチュートリアルには、Northwind サンプルデータベースが必要です。

開発用コンピューターにこのデータベースがインストールされていない場合は、Microsoft ダウンロードセンターからダウンロードできます。手順については、「Downloading Sample Databases (LINQ to SQL)」を参照してください。

概要

このチュートリアルの前半部分は、次の 4 つの主要な手順で構成されています。

ソリューションを作成する。
DataRepeater コントロールを追加する。
データソースを追加する。
データバインドコントロールを追加する。

[!メモ]

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

DataRepeater ソリューションの作成

最初に、プロジェクトおよびソリューションを作成します。

DataRepeater ソリューションを作成するには

Visual Studio の [ファイル] メニューの [新しいプロジェクト] をクリックします。
[新しいプロジェクト] ダイアログボックスの [プロジェクトの種類] ペインで、[Visual Basic] を展開し、[Windows] をクリックします。
[テンプレート] ペインの [Windows フォームアプリケーション] をクリックします。
[プロジェクト名] ボックスに「DataRepeaterApp」と入力します。
[OK] をクリックします。

Windows フォームデザイナーが開きます。
Windows フォームデザイナーでフォームを選択します。[プロパティ] ウィンドウで、Size プロパティを 800, 700 に設定します。

DataRepeater コントロールの追加

この手順では、フォームに DataRepeater コントロールを追加します。

DataRepeater コントロールを追加するには

[表示] メニューの [ツールボックス] をクリックします。

ツールボックスが表示されます。
[Visual Basic PowerPacks] タブをクリックします。
DataRepeater コントロールを Form1 にドラッグします。
[プロパティ] ウィンドウで、Location プロパティを 0, 25 に設定します。
Size プロパティを 460, 600 に設定します。

データソースの追加

この手順では、DataRepeater コントロールのデータソースを追加します。

データソースを追加するには

[データ] メニューの [データソースの表示] をクリックします。
[データソース] ウィンドウで、[新しいデータソースの追加] をクリックします。
[データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。
[データ接続の選択] ページで、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストに表示されている場合は、これをクリックします。
  
  または
- [新しい接続] をクリックし、新しいデータ接続を構成します。詳細については、「How to: Create Connections to SQL Server Databases」を参照してください。
データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。

[!メモ]

ダイアログボックスが表示された場合は、[はい] をクリックしてファイルをプロジェクトに保存します。
[アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。
[データベースオブジェクトの選択] ページの [テーブル] ノードを展開します。
Customers テーブルと Orders テーブルの横のチェックボックスをオンにし、[完了] をクリックします。

プロジェクトに NorthwindDataSet が追加され、[データソース] ウィンドウに Customers テーブルと Orders テーブルが表示されます。

データバインドコントロールの追加

この手順では、DataRepeater にデータバインドコントロールを追加します。

データバインドコントロールを追加するには

[データソース] ウィンドウで、Customers テーブルの最上位ノードを選択します。
テーブルノードのドロップダウンリストの [詳細] をクリックして、テーブルのドロップタイプを [詳細] に変更します。
[Customers] テーブルノードを選択し、DataRepeater コントロールの項目テンプレート領域 (上部領域) にドラッグします。

フォームに BindingNavigator コントロールが追加され、コンポーネントトレイに NorthwindDataSet、CustomersBindingSource、CustomersTableAdapter、TableAdapterManager、および CustomersBindingNavigator の各コンポーネントが追加されます。
すべてのフィールドとそれらに関連付けられているラベルを選択し、項目テンプレート領域の左端近くに配置します。
後半の 5 つのフィールド (Region、Postal Code、Country、Phone、および Fax) とそれらに関連付けられているラベルを選択し、上へ移動して前半の 6 つのフィールドの右側に配置します。
項目テンプレート (コントロールの上部領域) を選択します。
[プロパティ] ウィンドウで、Size プロパティを 427, 170 に設定します。

この時点で、顧客を独立した一覧で表示できるアプリケーションが作成されました。F5 キーを押してこのアプリケーションを実行し、データの変更、および顧客レコードの追加と削除を行うことができます。

次の省略可能な手順では、DataRepeater コントロールをカスタマイズする方法について説明します。

次の手順 (省略可能)

このチュートリアルの後半部分は、次の 4 つの省略可能な手順で構成されています。

DataRepeater コントロールの外観を変更する。
ユーザーがレコードの追加または削除を行うことができないようにする。
DataRepeater コントロールに検索機能を追加する。
DataRepeater コントロールにマスター/詳細テーブルを追加する。

DataRepeater コントロールの外観の変更

この省略可能な手順では、デザイン時に DataRepeater コントロールの BackColor を変更します。また、行の色を交互にし、条件に応じてラベルの ForeColor を変更するコードを追加します。

コントロールの外観を変更するには

Windows フォームデザイナーで、DataRepeater コントロールのメイン (下部) 領域を選択します。
[プロパティ] ウィンドウで、BackColor プロパティを白に設定します。
DataRepeater をダブルクリックしてコードエディターを表示します。
コードエディターで、[イベント] ボックスの一覧の [DrawItem] をクリックします。

DrawItem イベントハンドラーに、BackColor を交互にする次のコードを追加します。

' Alternate the back color.
If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then
    ' Apply the secondary back color.
    e.DataRepeaterItem.BackColor = Color.AliceBlue
Else
    ' Apply the default back color.
    e.DataRepeaterItem.BackColor = DataRepeater1.BackColor
End If

// Alternate the back color.
if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
// Apply the secondary back color.
{
    e.DataRepeaterItem.BackColor = Color.AliceBlue;
}
else
{
    // Apply the default back color.
    e.DataRepeaterItem.BackColor = dataRepeater1.BackColor;
}

DrawItem イベントハンドラーに、条件に応じてラベルの ForeColor を変更する次のコードを追加します。

If e.DataRepeaterItem.Controls(RegionTextBox.Name).Text = "" Then
    e.DataRepeaterItem.Controls("RegionLabel").
     ForeColor = Color.Red
Else
    e.DataRepeaterItem.Controls("RegionLabel").
     ForeColor = Color.Black
End If

if (e.DataRepeaterItem.Controls[regionTextBox.Name].Text == "")
{
    e.DataRepeaterItem.Controls["regionLabel"].ForeColor = Color.Red;
}
else
{
    e.DataRepeaterItem.Controls["regionLabel"].ForeColor = Color.Black;
}

F5 キーを押してアプリケーションを実行し、カスタマイズを確認します。

ユーザーがレコードの追加または削除を行うことができないようにする

この省略可能な手順では、ユーザーが DataRepeater コントロールでレコードの追加または削除を行うことができないようにするコードを追加します。

ユーザーがレコードの追加または削除を行うことができないようにするには

Windows フォームデザイナーで、フォームをダブルクリックしてコードエディターを開きます。

Form_Load イベントに次のコードを追加します。

DataRepeater1.AllowUserToAddItems = False
DataRepeater1.AllowUserToDeleteItems = False
BindingNavigatorAddNewItem.Enabled = False
CustomersBindingSource.AllowNew = False
BindingNavigatorDeleteItem.Enabled = False

dataRepeater1.AllowUserToAddItems = false;
dataRepeater1.AllowUserToDeleteItems = false;
bindingNavigatorAddNewItem.Enabled = false;
customersBindingSource.AllowNew = false;
bindingNavigatorDeleteItem.Enabled = false;

[クラス名] ドロップダウンリストで、[BindingNavigatorDeleteItem] をクリックします。[メソッド名] ドロップダウンリストで、[EnabledChanged] をクリックします。
BindingNavigatorDeleteItem_EnabledChanged イベントハンドラーに次のコードを追加します。
```
If BindingNavigatorDeleteItem.Enabled = True Then
    BindingNavigatorDeleteItem.Enabled = False
End If
```
```
if (bindingNavigatorDeleteItem.Enabled == true)
{
    bindingNavigatorDeleteItem.Enabled = false;
}
```
[!メモ]

現在のレコードが変更されるたびに BindingSource によって DeleteItem ボタンが有効になるため、この手順が必要となります。
F5 キーを押してアプリケーションを実行します。DeleteItem ボタンが無効になっており、Del キーを押しても項目を削除できないことを確認します。

DataRepeater コントロールへの検索機能の追加

この省略可能な手順では、DataRepeater コントロールで値を検索する機能を実装します。検索文字列が見つかると、このコントロールはその値を含む項目を選択し、スクロールして表示します。

検索機能を追加するには

DataRepeater コントロールを含んでいるフォームに、ツールボックスから TextBox コントロールをドラッグします。

それを DataRepeater コントロールの下に配置します。
[プロパティ] ウィンドウで、Name プロパティを SearchTextBox に変更します。
DataRepeater コントロールを含んでいるフォームに、ツールボックスから Button コントロールをドラッグします。それを DataRepeater コントロールの下に配置します。
[プロパティ] ウィンドウで、Name プロパティを SearchButton に変更します。Text プロパティを Search に変更します。

Button コントロールをダブルクリックしてコードエディターを開き、SearchButton_Click イベントハンドラーに次のコードを追加します。

Dim foundIndex As Integer
Dim searchString As String
searchString = SearchTextBox.Text
' Search for the string in the CustomerID field.
foundIndex = CustomersBindingSource.Find("CustomerID",
 searchString)
If foundIndex > -1 Then
    DataRepeater1.CurrentItemIndex = foundIndex
Else
    MsgBox("Item " & searchString & " not found.")
End If

int foundIndex;
string searchString;
searchString = searchTextBox.Text;
// Search for the string in the CustomerID field.
foundIndex = customersBindingSource.Find("CustomerID", searchString);
if (foundIndex > -1)
{
    dataRepeater1.CurrentItemIndex = foundIndex;
}
else
{
    MessageBox.Show("Item " + searchString + " not found.");
}

F5 キーを押してアプリケーションを実行します。[SearchTextBox] に顧客 ID を入力し、[検索] ボタンをクリックします。

DataRepeater へのマスター/詳細テーブルの追加

この省略可能な手順では、顧客ごとに関連する注文を表示する、2 番目の DataRepeater コントロールを追加します。

マスター/詳細テーブルを追加するには

ツールボックスの [Visual Basic PowerPacks] タブから 2 番目の DataRepeater コントロールをフォームにドラッグします。
[プロパティ] ウィンドウで、Location プロパティを 465, 25 に設定します。
Size プロパティを 315, 600 に設定します。
[データソース] ウィンドウで、[Customers] テーブルノードを展開し、Orders テーブルの詳細ノードを選択します。
この Orders テーブルのドロップタイプを、テーブルノードのドロップダウンリストの [詳細] をクリックして [詳細] に変更します。
この [Orders] テーブルノードを 2 番目の DataRepeater コントロールの項目テンプレート領域 (上部領域) にドラッグします。

OrdersBindingSource コンポーネントおよび OrdersTableAdapter コンポーネントがコンポーネントトレイに追加されます。
F5 キーを押してアプリケーションを実行します。1 番目の DataRepeater コントロールで顧客を選択すると、2 番目の DataRepeater コントロールにその顧客の注文が表示されます。

参照

処理手順

方法 : DataRepeater コントロールにバインドされたデータを表示する (Visual Studio)

方法 : DataRepeater コントロールに非バインドデータを表示する (Visual Studio)

方法 : DataRepeater コントロールのレイアウトを変更する (Visual Studio)

方法 : DataRepeater コントロールに項目ヘッダーを表示する (Visual Studio)

方法 : DataRepeater コントロールでデータを検索する (Visual Studio)

方法 : 2 つの DataRepeater コントロールを使用してマスター/詳細形式のフォームを作成する (Visual Studio)

方法 : DataRepeater コントロールの外観を変更する (Visual Studio)

方法 : DataRepeater の項目の追加と削除を無効にする (Visual Studio)

DataRepeater コントロールのトラブルシューティング (Visual Studio)

概念

DataRepeater コントロールの概要 (Visual Studio)

次の方法で共有

チュートリアル : DataRepeater コントロールでのデータの表示 (Visual Studio)

[必須コンポーネント]

概要

DataRepeater ソリューションの作成

DataRepeater ソリューションを作成するには

DataRepeater コントロールの追加

DataRepeater コントロールを追加するには

データソースの追加

データソースを追加するには

データバインドコントロールの追加

データバインドコントロールを追加するには

次の手順 (省略可能)

DataRepeater コントロールの外観の変更

コントロールの外観を変更するには

ユーザーがレコードの追加または削除を行うことができないようにする

ユーザーがレコードの追加または削除を行うことができないようにするには

DataRepeater コントロールへの検索機能の追加

検索機能を追加するには

DataRepeater へのマスター/詳細テーブルの追加

マスター/詳細テーブルを追加するには

参照

処理手順

概念

その他のリソース

次の方法で共有

チュートリアル : DataRepeater コントロールでのデータの表示 (Visual Studio)

[必須コンポーネント]

概要

DataRepeater ソリューションの作成

DataRepeater ソリューションを作成するには

DataRepeater コントロールの追加

DataRepeater コントロールを追加するには

データ ソースの追加

データ ソースを追加するには

データ バインド コントロールの追加

データ バインド コントロールを追加するには

次の手順 (省略可能)

DataRepeater コントロールの外観の変更

コントロールの外観を変更するには

ユーザーがレコードの追加または削除を行うことができないようにする

ユーザーがレコードの追加または削除を行うことができないようにするには

DataRepeater コントロールへの検索機能の追加

検索機能を追加するには

DataRepeater へのマスター/詳細テーブルの追加

マスター/詳細テーブルを追加するには

参照

処理手順

概念

その他のリソース

データソースの追加

データソースを追加するには

データバインドコントロールの追加

データバインドコントロールを追加するには