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

Статья
11/01/2012

Получает шаблон, который представляет DataRepeaterItem для a DataRepeater элемент управления.

Пространство имен: Microsoft.VisualBasic.PowerPacks
Сборка: Microsoft.VisualBasic.PowerPacks.Vs (в Microsoft.VisualBasic.PowerPacks.Vs.dll)

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem

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

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

[<BrowsableAttribute(false)>]
member ItemTemplate : DataRepeaterItem

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 a TextBox имя IDTextBox, можно использовать следующий код:

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

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

Примеры

Некоторые стандартные настройки для элемента управления DataRepeater включают возможности отображения строк различными цветами и изменения цвета поля на основе условия.Выполнение этих настроек показано в следующем примере.Пример предполагает наличие элемента управления DataRepeater, привязанного к таблице "Продукты" в базе данных 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.
        e.DataRepeaterItem.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.
        e.DataRepeaterItem.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;
    }
}

Безопасность платформы .NET Framework

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