DataRepeaterItemValueEventArgs (Constructor)

Artículo
05/17/2015

Inicializa una nueva instancia de la clase DataRepeaterItemValueEventArgs.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
Public Sub New ( _
    itemIndex As Integer, _
    control As Control, _
    propertyName As String, _
    value As Object _
)

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 function DataRepeaterItemValueEventArgs(
    itemIndex : int, 
    control : Control, 
    propertyName : String, 
    value : Object
)

Parámetros

itemIndex
Tipo: Int32

Índice de DataRepeaterItem que contiene el control que está provocando el evento.

control
Tipo: Control

propertyName
Tipo: String

La propiedad del control que ha cambiado o que necesita datos.

value
Tipo: Object

Valor de propiedad que ha cambiado.

Comentarios

En modo virtual, el evento de ItemValueNeeded para rellenar los controles secundarios de ItemTemplate con la configuración del almacén de datos cuando se muestra DataRepeaterItem o cuando se agrega un nuevo elemento.

Utilice el evento de ItemValuePushed para guardar los cambios en los valores del control secundario al almacén de datos.

Cuando la propiedad de VirtualMode se establece en False, estos eventos no se provocan.

Ejemplos

En el siguiente ejemplo se muestra cómo controlar el evento ItemValueNeeded. Se supone que tiene un control de DataRepeater denominado DataRepeater1 que tiene la propiedad de VirtualMode establecida en True. The que el código será similar al siguiente ejemplo, para un origen de datos denominado 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;
        }
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.