DataRepeaterItem 類別
更新:2007 年 11 月
DataRepeater 控制項用於在執行階段顯示資料。
命名空間: Microsoft.VisualBasic.PowerPacks
組件: Microsoft.VisualBasic.PowerPacks.Vs (在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)
語法
<DockingAttribute(DockingBehavior.Never)> _
Public Class DataRepeaterItem _
Inherits Panel
Dim instance As DataRepeaterItem
[DockingAttribute(DockingBehavior.Never)]
public class DataRepeaterItem : Panel
[DockingAttribute(DockingBehavior::Never)]
public ref class DataRepeaterItem : public Panel
public class DataRepeaterItem extends Panel
備註
DataRepeater 控制項使用 DataRepeaterItem 物件,顯示控制項中每個已捲動到檢視的項目。只要項目已捲動到檢視範圍之外,DataRepeaterItem 就會失效,並由下一個可見的項目的新 DataRepeaterItem 取代。
每個項目的配置和外觀都是以 ItemTemplate 屬性為基礎。當每個 DataRepeaterItem 呈現時,您就可以在 DrawItem 事件中修改外觀。
注意事項: |
---|
請只修改可以從 DrawItem 事件存取的 DataRepeaterItem。試圖在此事件以外修改它或嘗試建立新的 DataRepeaterItem 都可能會產生未預期的結果。 |
範例
下列範例示範如何在項目捲動到檢視範圍內時,使用 DrawItem 事件處理常式來進行變更。這個範例假設您有一個 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.
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;
}
}
繼承階層架構
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.Panel
Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
執行緒安全
這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。
請參閱
參考
Microsoft.VisualBasic.PowerPacks 命名空間