DataRepeater.ItemValueNeeded, événement

Article
09/04/2008

Mise à jour : novembre 2007

Se produit lorsque la propriété VirtualMode a la valeur True et qu'une nouvelle valeur pour un contrôle enfant d'un DataRepeaterItem est nécessaire.

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

Syntaxe

Public Event ItemValueNeeded As DataRepeaterItemValueEventHandler

Dim instance As DataRepeater
Dim handler As DataRepeaterItemValueEventHandler

AddHandler instance.ItemValueNeeded, handler

public event DataRepeaterItemValueEventHandler ItemValueNeeded

public:
 event DataRepeaterItemValueEventHandler^ ItemValueNeeded {
    void add (DataRepeaterItemValueEventHandler^ value);
    void remove (DataRepeaterItemValueEventHandler^ value);
}

JScript ne prend pas en charge les événements.

Notes

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

Lorsque la propriété VirtualMode a la valeur False, cet événement n'est pas déclenché.

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

Exemples

L'exemple suivant montre comment gérer l'événement ItemValueNeeded. Il suppose que vous disposez d'un contrôle DataRepeater nommé DataRepeater1 dont la propriété VirtualMode a la valeur True, ainsi que d'un magasin de données pour une source de données appelé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;
        }
    }
}

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.