DataRepeater.ItemTemplate 属性

项目
10/25/2012

获取表示 DataRepeater 控件的 DataRepeaterItem 的模板。

命名空间： Microsoft.VisualBasic.PowerPacks
程序集： Microsoft.VisualBasic.PowerPacks.Vs（在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中）

语法

声明
<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem

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

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

[<BrowsableAttribute(false)>]
member ItemTemplate : DataRepeaterItem

function get ItemTemplate () : DataRepeaterItem

属性值

类型：Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
确定项目布局和外观。 DataRepeater 控件的对象。

备注

使用 ItemTemplate 属性设置确定所有项目运行时的外观。 DataRepeater 控件的属性。实际上，您实际设置将在运行时创建 DataRepeaterItem 对象的属性。在 DataRepeater 看到在运行时将项目从此对象复制，当用户滚动到视图。

在设计时，那么，当您选择包含控件 DataRepeater 的部分时， " 属性 " 窗口包含 ItemTemplate的属性。例如，设置 ItemTemplate 的 BackColor 属性设置为 Red 中 DataRepeater 使所有项显示为具有红色背景。

在运行时，因此，如果更改 ItemTemplate的属性，必须在设置属性之前调用 BeginResetItemTemplate 方法，然后调用 EndResetItemTemplate 方法提交更改。

ItemTemplate 属性也用于访问控件在 DataRepeaterItem 在运行时。例如，检索 TextBox 的 BackColor 名为 IDTextBox，您将使用以下代码:

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

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

示例

DataRepeater 控件的一些常见自定义包括以交替颜色显示行以及基于条件更改字段的颜色。下面的示例演示如何执行这些自定义项。此示例假定您有一个 DataRepeater 控件，该控件绑定到 Northwind 数据库的 Products 表。

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.
        e.DataRepeaterItem.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.
        e.DataRepeaterItem.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;
    }
}