DataRepeaterItemValueEventArgs Constructor (Int32, Control, String, Object)
Initializes a new instance of the DataRepeaterItemValueEventArgs class.
Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)
Syntax
public DataRepeaterItemValueEventArgs(
int itemIndex,
Control control,
string propertyName,
object value
)
public:
DataRepeaterItemValueEventArgs(
int itemIndex,
Control^ control,
String^ propertyName,
Object^ value
)
new :
itemIndex:int *
control:Control *
propertyName:string *
value:Object -> DataRepeaterItemValueEventArgs
Public Sub New (
itemIndex As Integer,
control As Control,
propertyName As String,
value As Object
)
Parameters
itemIndex
Type: System.Int32The index of the DataRepeaterItem that contains the control that is raising the event.
- ctl
The child control that is raising the event.
propertyName
Type: System.StringThe property of the control that has changed or that needs data.
value
Type: System.ObjectThe property value that has changed.
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 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;
}
}
}
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
See Also
ItemValuePushed
ItemValueNeeded
DataRepeaterItemValueEventArgs Class
Microsoft.VisualBasic.PowerPacks Namespace
Introduction to the DataRepeater Control (Visual Studio)
Virtual Mode in the DataRepeater Control (Visual Studio)
Return to top