DataRepeater.ItemValueNeeded - событие

Статья
11/05/2008

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

Возникает, когда свойство VirtualMode имеет значение True и требуется новое значение для дочернего элемента управления элемента DataRepeaterItem.

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

Синтаксис

'Декларация
Public Event ItemValueNeeded As DataRepeaterItemValueEventHandler
'Применение
Dim instance As DataRepeater
Dim handler As DataRepeaterItemValueEventHandler

AddHandler instance.ItemValueNeeded, handler

public event DataRepeaterItemValueEventHandler ItemValueNeeded

public:
 event DataRepeaterItemValueEventHandler^ ItemValueNeeded {
    void add (DataRepeaterItemValueEventHandler^ value);
    void remove (DataRepeaterItemValueEventHandler^ value);
}

JScript не поддерживает события.

Заметки

В виртуальном режиме это событие используется для заполнения дочерних элементов управления значениями из хранилища данных, когда отображается элемент DataRepeaterItem или добавляется новый элемент.

Если свойству VirtualMode задается значение False, данное событие не возникает.

Дополнительные сведения об обработке событий см. в разделе Прием событий.

Примеры

В следующем примере показана обработка события ItemValueNeeded. Пример предполагает наличие элемента управления DataRepeater с именем DataRepeater1 и свойством VirtualMode, имеющим значение True, а также хранилище данных для источника данных с именем Employees.

Private Sub DataRepeater1_ItemValueNeeded(ByVal sender As Object, _
 ByVal e As  _
 Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs) _
 Handles DataRepeater1.ItemValueNeeded
    If e.ItemIndex < Employees.Count Then
        Select Case e.Control.Name
            Case "txtFirstName"
                e.Value = Employees.Item(e.ItemIndex + 1).firstName
            Case "txtLastName"
                e.Value = Employees.Item(e.ItemIndex + 1).lastName
        End Select
    End If
End Sub

private void dataRepeater1_ItemValueNeeded(object sender, Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs e)
{
    if (e.ItemIndex < Employees.Count)
    {
        switch (e.Control.Name)
        {
            case "txtFirstName":
                e.Value = Employees[e.ItemIndex + 1].firstName;
                break;
            case "txtLastName":
                e.Value = Employees[e.ItemIndex + 1].lastName;
                break;
        }
    }
}

Разрешения

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