DataRepeater.ItemTemplate 屬性

發行項
10/31/2012

命名空間： 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。比方說，設定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 資料庫中的 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;
    }
}