DataRepeaterItem 클래스

아티클
08/22/2008

업데이트: 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 이벤트 처리기를 사용하여 항목이 뷰로 스크롤될 때 변경되도록 하는 방법을 보여 줍니다. 이 예제에서는 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;
    }
}