DataRepeaterItemEventArgs.DataRepeaterItem - свойство

Статья
11/05/2008

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

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

Пространство имен: 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
Элемент, содержащий данные, основанные на свойстве ItemTemplate элемента управления DataRepeater.

Заметки

Событие DrawItem используется для изменения внешнего вида объектов DataRepeaterItem при их прокрутке в представлении.

Во время выполнения свойства, связанные с отображением, можно установить в зависимости от ситуации. Например, в приложении планирования можно изменить цвет фона элемента для предупреждения пользователей о просроченных элементах. Если значение свойства задается в условном операторе, например If…Then, необходимо также использовать предложение Else, чтобы указать вид элемента, если условие не будет выполнено.

Примеры

В следующем примере показано использование обработчика событий DrawItem для внесения изменений при прокрутке элемента в представлении. Пример предполагает наличие элемента управления 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.
        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;
    }
}

Разрешения

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