DataRepeaterItemValueEventArgs (Clase)

Artículo
05/17/2015

Proporciona datos para los eventos ItemValueNeeded y ItemValuePushed.

Jerarquía de herencia

Object
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
	DataRepeaterItemValueEventArgs	Inicializa una nueva instancia de la clase DataRepeaterItemValueEventArgs.

Arriba

Propiedades

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

Arriba

Métodos

	Nombre	Descripción
	Equals	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Sirve como la función hash predeterminada. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	MemberwiseClone	Crea una copia superficial del Object actual. (Se hereda de Object).
	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.