DataRepeaterItemValueEventArgs (Clase)

Proporciona datos para los eventos ItemValueNeeded y ItemValuePushed.

Jerarquía de herencia

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

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

Sintaxis

'Declaración
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

El tipo DataRepeaterItemValueEventArgs expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público DataRepeaterItemValueEventArgs Inicializa una nueva instancia de la clase DataRepeaterItemValueEventArgs.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública Control Obtiene el control secundario de DataRepeaterItem que está provocando el evento de ItemValueNeeded o de ItemValuePushed .
Propiedad pública ItemIndex Obtiene el índice de DataRepeaterItem que contiene el control que está provocando el evento de ItemValueNeeded o de ItemValuePushed .
Propiedad pública PropertyName Obtiene el nombre de la propiedad enlazada a datos del control que está generando un evento de ItemValueNeeded o de ItemValuePushed .
Propiedad pública Value Obtiene el valor de la propiedad que ha cambiado para provocar un evento de ItemValueNeeded o de ItemValuePushed .

Arriba

Métodos

  Nombre Descripción
Método público Equals Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegido Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

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 para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

Microsoft.VisualBasic.PowerPacks (Espacio de nombres)

ItemValuePushed

ItemValueNeeded

Otros recursos

Introducción al control DataRepeater (Visual Studio)

Modo virtual del control DataRepeater (Visual Studio)