DataRepeaterItemValueEventArgs.PropertyName Property
Gets the name of the data-bound property of the control that is raising a ItemValueNeeded or ItemValuePushed event.
Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)
Syntax
'Declaration
Public ReadOnly Property PropertyName As String
public string PropertyName { get; }
public:
property String^ PropertyName {
String^ get ();
}
member PropertyName : string
function get PropertyName () : String
Property Value
Type: String
The name of the property.
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;
}
}
}
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
See Also
Reference
DataRepeaterItemValueEventArgs Class
Microsoft.VisualBasic.PowerPacks Namespace