DataRepeater.ItemValueNeeded-Ereignis

Artikel
08/23/2008

Aktualisiert: November 2007

Wird ausgelöst, wenn die VirtualMode-Eigenschaft auf True festgelegt ist und ein neuer Wert für ein untergeordnetes Steuerelement von DataRepeaterItem erforderlich ist.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

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 unterstützt keine Ereignisse.

Hinweise

Verwenden Sie im virtuellen Modus dieses Ereignis, um die untergeordneten Steuerelemente mit Werten aus Ihrem Datenspeicher aufzufüllen, wenn ein DataRepeaterItem angezeigt wird oder wenn ein neues Element hinzugefügt wird.

Wenn die VirtualMode-Eigenschaft auf False festgelegt ist, wird das Ereignis nicht ausgelöst.

Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie das ItemValueNeeded-Ereignis behandelt wird. Es wird davon ausgegangen, dass Sie über ein DataRepeater-Steuerelement mit dem Namen DataRepeater1 verfügen, dessen VirtualMode-Eigenschaft auf True festgelegt ist, und dass Sie über einen Datenspeicher für eine Datenquelle mit dem Namen Employees verfügen.

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;
        }
    }
}

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.