DataRepeater.ItemTemplate 속성

아티클
08/22/2008

업데이트: 2007년 11월

DataRepeater 컨트롤의 DataRepeaterItem을 나타내는 템플릿을 가져옵니다.

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

구문

<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem

Dim instance As DataRepeater
Dim value As DataRepeaterItem

value = instance.ItemTemplate

[BrowsableAttribute(false)]
public DataRepeaterItem ItemTemplate { get; }

[BrowsableAttribute(false)]
public:
property DataRepeaterItem^ ItemTemplate {
    DataRepeaterItem^ get ();
}

public function get ItemTemplate () : DataRepeaterItem

속성 값

형식: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

DataRepeater 컨트롤의 항목에 대한 레이아웃과 모양을 결정하는 개체입니다.

설명

ItemTemplate 속성을 사용하여 DataRepeater 컨트롤의 모든 항목에 대한 런타임 모양을 결정하는 속성을 설정합니다. 결과적으로 런타임에 만들어지는 DataRepeaterItem 개체의 속성을 설정하게 됩니다. 런타임에 DataRepeater에 표시되는 항목은 뷰로 스크롤될 때 이 개체에서 복사됩니다.

디자인 타임에 컨트롤이 포함된 DataRepeater 부분을 선택하면 속성 창에 ItemTemplate에 대한 속성이 포함됩니다. 예를 들어 ItemTemplate의 BackColor 속성을 Red로 설정하면 DataRepeater의 모든 항목이 빨간색 배경과 함께 표시됩니다.

런타임에 ItemTemplate의 속성을 변경하는 경우 속성을 설정하기 전에 BeginResetItemTemplate 메서드를 호출한 다음 EndResetItemTemplate 메서드를 호출하여 변경 내용을 커밋해야 합니다.

ItemTemplate 속성은 런타임에 DataRepeaterItem의 컨트롤에 액세스하는 데에도 사용됩니다. 예를 들어 IDTextBox라는 TextBox의 BackColor를 검색하려면 다음 코드를 사용합니다.

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

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

예제

일반적으로 DataRepeater 컨트롤은 행을 다른 색으로 표시하거나 조건에 따라 필드의 색을 변경하는 등의 방식으로 사용자 지정할 수 있습니다. 다음 예제에서는 사용자 지정 작업을 수행하는 방법을 보여 줍니다. 이 예제에서는 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;
    }
}