DataRepeaterItemValueEventArgs, classe

Article
11/15/2012

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

Hiérarchie d'héritage

System.Object
System.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'DataRepeaterItem qui déclenche l'événement d'ItemValueNeeded ou d'ItemValuePushed.
	ItemIndex	Obtient l'index d'DataRepeaterItem qui contient le contrôle qui déclenche l'événement d'ItemValueNeeded ou d'ItemValuePushed.
	PropertyName	Obtient le nom de la propriété de cas du contrôle qui déclenche un événement d'ItemValueNeeded ou d'ItemValuePushed.
	Value	Obtient la valeur de propriété qui a changé pour déclencher un événement d'ItemValueNeeded ou d'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 d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Notes

Dans le mode virtuel, utilisez l'événement d'ItemValueNeeded pour remplir contrôles enfants d'ItemTemplate avec des 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 des modifications aux valeurs de contrôle enfant à votre magasin de données.

Lorsque la propriété d'VirtualMode est définie à False, ces événements ne sont pas déclenché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 possédant son jeu de propriétés d'VirtualMode à True. que code ressemblera à l'exemple suivant, qui est conçu pour 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.