DataRepeaterItemValueEventArgs Class

Provides data for the ItemValueNeeded and ItemValuePushed events.

Namespace:  Microsoft.VisualBasic.PowerPacks
Assembly:  Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
Public Class DataRepeaterItemValueEventArgs _
    Inherits EventArgs
'Usage
Dim instance As DataRepeaterItemValueEventArgs
public class DataRepeaterItemValueEventArgs : EventArgs
public ref class DataRepeaterItemValueEventArgs : public EventArgs
public class DataRepeaterItemValueEventArgs extends EventArgs

Remarks

In virtual mode, use the ItemValueNeeded event to populate the child controls of the ItemTemplate with values from your data store when a DataRepeaterItem is displayed or when a new item is added.

Use the ItemValuePushed event to save changes to the child control values to your data store.

When the VirtualMode property is set to False, these events are not raised.

Examples

The following example demonstrates how to handle the ItemValueNeeded event. It assumes that you have a DataRepeater control named DataRepeater1 that has its VirtualMode property set to True. The code will resemble the following example, which is for a data source named 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;
        }
    }
}

Inheritance Hierarchy

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

DataRepeaterItemValueEventArgs Members

Microsoft.VisualBasic.PowerPacks Namespace

ItemValuePushed

ItemValueNeeded

Other Resources

Introduction to the DataRepeater Control (Visual Studio)

Virtual Mode in the DataRepeater Control (Visual Studio)