DataRepeater.ItemTemplate - свойство

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает шаблон, представляющий элемент DataRepeaterItem для элемента управления DataRepeater.

Пространство имен: 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. Например, если свойству 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, привязанного к таблице “Products” в базе данных Northwind.

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;
    }
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.