DataRepeaterItemValueEventArgs 类

项目
10/25/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	获取引发 ItemValueNeeded 或 ItemValuePushed 事件 DataRepeaterItem 的子控件。
	ItemIndex	获取包含控件引发 ItemValueNeeded 或 ItemValuePushed 事件 DataRepeaterItem 的索引。
	PropertyName	获取控件的数据特性的名称引发 ItemValueNeeded 或 ItemValuePushed 事件。
	Value	获取更改都会引发 ItemValueNeeded 或 ItemValuePushed 事件的属性值。

页首

方法

	名称	说明
	Equals	确定指定的对象是否等于当前对象。（继承自 Object。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
	GetHashCode	用作特定类型的哈希函数。（继承自 Object。）
	GetType	获取当前实例的 Type。（继承自 Object。）
	MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
	ToString	返回表示当前对象的字符串。（继承自 Object。）

页首

备注

在虚拟模式下，请使用 ItemValueNeeded 事件填充 ItemTemplate 的子控件的值从数据存储区，当 DataRepeaterItem 显示时，或者当添加新项时时。

使用 ItemValuePushed 事件保存到子控件的值的更改到数据存储区。

当 VirtualMode 属性设置为 False时，不会引发这些事件。

示例

下面的示例说明如何处理 ItemValueNeeded 事件。它，假设您具有其 VirtualMode 属性设置为 True.代码与下面的示例类似，针对一个名为 Employees的数据源名为 DataRepeater1 的一个 DataRepeater 控件。

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