DataRepeater.ItemTemplate プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

DataRepeater コントロールの DataRepeaterItem を表すテンプレートを取得します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem
'使用
Dim instance As DataRepeater
Dim value As DataRepeaterItem

value = instance.ItemTemplate

[BrowsableAttribute(false)]
public DataRepeaterItem ItemTemplate { get; }

[BrowsableAttribute(false)]
public:
property DataRepeaterItem^ ItemTemplate {
    DataRepeaterItem^ get ();
}

public function get ItemTemplate () : DataRepeaterItem

プロパティ値

型 : Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

DataRepeater コントロール内の項目のレイアウトと外観を決定するオブジェクト。

解説

DataRepeater コントロール内のすべての項目の実行時の外観を決定するプロパティを設定するには、ItemTemplate プロパティを使用します。実際には、実行時に作成される DataRepeaterItem オブジェクトのプロパティを設定することになります。実行時に DataRepeater に表示される項目は、スクロールして表示されるときにこのオブジェクトからコピーされます。

デザイン時に、コントロールが含まれる DataRepeater の部分を選択すると、[プロパティ] ウィンドウには、ItemTemplate のプロパティが表示されます。たとえば、ItemTemplate の BackColor プロパティを Red に設定すると、DataRepeater 内のすべての項目が赤色の背景で表示されます。

実行時に、ItemTemplate のプロパティを変更する場合は、プロパティを設定する前に BeginResetItemTemplate メソッドを呼び出し、次に EndResetItemTemplate メソッドを呼び出して、変更をコミットする必要があります。

ItemTemplate プロパティは、実行時に DataRepeaterItem 内のコントロールにアクセスするためにも使用できます。たとえば、IDTextBox という名前の TextBox の BackColor を取得するには、次のコードを使用します。

Dim BC As Color = _
 DataRepeater1.ItemTemplate.Controls(IDTextBox.Name).BackColor

color BC = dataRepeater1.ItemTemplate.Controls["IDTextBox"].BackColor;

例

DataRepeater コントロールの一般的なカスタマイズの例として、行の色を交互にする、条件に基づいてフィールドの色を変更する、などが挙げられます。このようなカスタマイズを行う方法を次の例に示します。この例は、Northwind データベースの Products テーブルにバインドされた DataRepeater コントロールがあることを前提としています。

Private Sub DataRepeater1_DrawItem(ByVal sender As Object, ByVal e _
 As Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs) _
 Handles DataRepeater1.DrawItem
    ' 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.
        DataRepeater1.ItemTemplate.BackColor = Color.White
    End If
    ' Change the color of out-of-stock items to red.
    If e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name).Text _
     < 1 Then
        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). _
         BackColor = Color.Red
    Else
        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). _
         BackColor = Color.White
    End If
End Sub

private void dataRepeater1_DrawItem(object sender, 
    Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs e)
{
    // 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.
        dataRepeater1.ItemTemplate.BackColor = Color.White;
    }
    // Change the color of out-of-stock items to red.
    if (e.DataRepeaterItem.Controls["unitsInStockTextBox"].Text == "0")
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.Red;
    }
    else
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.White;
    }
}