DataRepeaterItemValueEventArgs, classe

Article
05/16/2015

Fournit des données pour les événements ItemValueNeeded et ItemValuePushed.

Hiérarchie d'héritage

Object
EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
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

Le type DataRepeaterItemValueEventArgs expose les membres suivants.

Constructeurs

	Nom	Description
	DataRepeaterItemValueEventArgs	Initialise une nouvelle instance de la classe DataRepeaterItemValueEventArgs.

Début

Propriétés

	Nom	Description
	Control	Obtient le contrôle enfant d'un DataRepeaterItem qui déclenche l'événement ItemValueNeeded ou ItemValuePushed .
	ItemIndex	Obtient l'index de l'DataRepeaterItem contenant le contrôle qui déclenche l'événement ItemValueNeeded ou ItemValuePushed.
	PropertyName	Obtient le nom de la propriété liée aux données du contrôle qui déclenche un événement ItemValueNeeded ou ItemValuePushed.
	Value	Obtient la valeur de la propriété qui a été modifiée pour déclencher un événement ItemValueNeeded ou ItemValuePushed.

Début

Méthodes

	Nom	Description
	Equals	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage par défaut. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle du Object actuel. (Hérité de Object.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Notes

En mode virtuel, utilisez l'événement d'ItemValueNeeded pour remplir les contrôles enfants d'ItemTemplate avec les valeurs de votre magasin de données lorsque DataRepeaterItem est affiché ou lorsqu'un nouvel élément est ajouté.

Utilisez l'événement d'ItemValuePushed pour enregistrer les modifications apportées aux valeurs de contrôle enfant à un magasin de données.

Lorsque la propriété d'VirtualMode est définie à False, les événements ne sont pas activés.

Exemples

L'exemple suivant montre comment gérer l'événement ItemValueNeeded. Il suppose que vous avez un contrôle d'DataRepeater nommé DataRepeater1 qui contient le jeu de propriétés d'VirtualMode à True. le code ressemblera à l'exemple suivant, qui est destinée à une source de données nommée 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;
        }
    }
}

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.