DataRepeaterItemEventArgs.DataRepeaterItem 속성

아티클
08/22/2008

업데이트: 2007년 11월

DataRepeater 컨트롤의 DrawItem 이벤트에 대한 데이터를 제공하는 DataRepeaterItem을 가져옵니다.

네임스페이스: Microsoft.VisualBasic.PowerPacks
어셈블리: Microsoft.VisualBasic.PowerPacks.Vs(Microsoft.VisualBasic.PowerPacks.Vs.dll)

구문

Public ReadOnly Property DataRepeaterItem As DataRepeaterItem

Dim instance As DataRepeaterItemEventArgs
Dim value As DataRepeaterItem

value = instance.DataRepeaterItem

public DataRepeaterItem DataRepeaterItem { get; }

public:
property DataRepeaterItem^ DataRepeaterItem {
    DataRepeaterItem^ get ();
}

public function get DataRepeaterItem () : DataRepeaterItem

속성 값

형식: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

DataRepeater 컨트롤의 ItemTemplate 속성을 기반으로 하는 데이터가 들어 있는 항목입니다.

설명

DrawItem 이벤트를 사용하여, 뷰로 스크롤될 때 DataRepeaterItem 개체의 모양을 변경합니다.

런타임에 조건에 따라 모양 관련 속성을 설정할 수 있습니다. 예를 들어 일정 응용 프로그램에서 항목이 기한을 넘기면 항목의 배경색을 변경하여 사용자에게 경고할 수 있습니다. If...Then과 같은 조건문에서 속성을 설정하는 경우 Else 절을 사용하여 조건에 맞지 않을 때의 모양도 지정해야 합니다.

예제

다음 예제에서는 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;
    }
}