DataRepeater.ItemTemplate 屬性

發行項
05/16/2015

命名空間： 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 with get

function get ItemTemplate () : DataRepeaterItem

屬性值

類型：Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
物件，其決定的配置和外觀中的項目DataRepeater控制項。

備註

使用ItemTemplate屬性來設定屬性來判斷所有項目中的執行的階段外觀DataRepeater控制項。作用中，您實際上要設定屬性的DataRepeaterItem物件將會建立於執行階段。在您看到的項目DataRepeater在執行階段會複製從這個物件，它們會捲動到檢視。

在設計階段，當您選取的區段DataRepeater，其中包含控制項後，[屬性] 視窗會包含屬性ItemTemplate。例如，將設定BackColor屬性ItemTemplate至Red中的所有項目會導致DataRepeater以紅色背景顯示。

如果您變更的屬性，在執行階段， ItemTemplate，您必須呼叫BeginResetItemTemplate方法，然後再設定此屬性，並且再呼叫EndResetItemTemplate方法，以認可變更。

ItemTemplate屬性也用來存取中的控制項DataRepeaterItem在執行階段。例如，若要擷取BackColor的TextBox名為IDTextBox，您會使用下列程式碼：

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

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

範例

一些常見的自訂DataRepeater控制項包含替代色彩和變更色彩根據條件的欄位中顯示資料列。下列範例示範如何執行這些自訂項目。這個範例假設您有DataRepeater繫結至 Northwind 資料庫中的 [產品] 資料表的控制項。

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;
    }
}