DataRepeaterItemValueEventArgs - класс

Статья
11/01/2012

Предоставляет данные для событий ItemValueNeeded и ItemValuePushed.

Иерархия наследования

System.Object
System.EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs

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

Синтаксис

'Декларация
Public Class DataRepeaterItemValueEventArgs _
    Inherits EventArgs

public class DataRepeaterItemValueEventArgs : EventArgs

public ref class DataRepeaterItemValueEventArgs : public EventArgs

type DataRepeaterItemValueEventArgs =  
    class
        inherit EventArgs
    end

public class DataRepeaterItemValueEventArgs extends EventArgs

Тип DataRepeaterItemValueEventArgs предоставляет следующие члены.

Конструкторы

	Имя	Описание
	DataRepeaterItemValueEventArgs	Инициализирует новый экземпляр класса DataRepeaterItemValueEventArgs.

В начало страницы

Свойства

	Имя	Описание
	Control	Получает дочерний элемент управления, a DataRepeaterItem то вызов ItemValueNeeded OR ItemValuePushed событие.
	ItemIndex	Возвращает индекс DataRepeaterItem содержащий элемент управления, возведение ItemValueNeeded OR ItemValuePushed событие.
	PropertyName	Возвращает имя данные-привязанного свойства элемента управления, который вызывает a ItemValueNeeded OR ItemValuePushed событие.
	Value	Возвращает значение свойства, которое было изменено для вызова a ItemValueNeeded OR ItemValuePushed событие.

В начало страницы

Методы

	Имя	Описание
	Equals	Определяет, равен ли заданный объект текущему объекту. (Унаследовано от Object.)
	Finalize	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
	GetHashCode	Играет роль хэш-функции для определенного типа. (Унаследовано от Object.)
	GetType	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
	MemberwiseClone	Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
	ToString	Возвращает строку, которая представляет текущий объект. (Унаследовано от Object.)

В начало страницы

Заметки

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

Используйте ItemValuePushed событие, чтобы сохранить изменения значений дочерних элементов управления в хранилище данных.

После VirtualMode свойство имеет значение Falseэти события не вызываются.

Примеры

В следующем примере показана обработка события ItemValueNeeded.Она предполагает наличие a 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;
        }
    }
}

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.