DataRepeaterItemValueEventArgs Class
Provides data for the ItemValueNeeded and ItemValuePushed events.
Inheritance Hierarchy
System.Object
System.EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs
Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)
Syntax
'Declaration
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
The DataRepeaterItemValueEventArgs type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
DataRepeaterItemValueEventArgs | Initializes a new instance of the DataRepeaterItemValueEventArgs class. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Control | Gets the child control of a DataRepeaterItem that is raising the ItemValueNeeded or ItemValuePushed event. |
|
ItemIndex | Gets the index of the DataRepeaterItem that contains the control that is raising the ItemValueNeeded or ItemValuePushed event. |
|
PropertyName | Gets the name of the data-bound property of the control that is raising a ItemValueNeeded or ItemValuePushed event. |
|
Value | Gets the property value that has changed to raise a ItemValueNeeded or ItemValuePushed event. |
Top
Methods
| Name | Description | |
|---|---|---|
|
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
.gif "Protected method") |
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
|
GetHashCode | Serves as the default hash function. (Inherited from Object.) |
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
ToString | Returns a string that represents the current object. (Inherited from Object.) |
Top
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;
}
}
}
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
Microsoft.VisualBasic.PowerPacks Namespace