DataRepeater.ItemValueNeeded-Ereignis

Artikel
10/24/2012

Tritt ein, wenn die VirtualMode-Eigenschaft auf True festgelegt ist und ein neuer Wert für ein untergeordnetes Steuerelement aus DataRepeaterItem benötigt wird.

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

Syntax

'Declaration
Public Event ItemValueNeeded As DataRepeaterItemValueEventHandler

public event DataRepeaterItemValueEventHandler ItemValueNeeded

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

member ItemValueNeeded : IEvent<DataRepeaterItemValueEventHandler,
    DataRepeaterItemValueEventArgs>

JScript unterstützt keine Ereignisse.

Hinweise

Im virtuellen Modus verwenden Sie dieses Ereignis, um die untergeordneten Steuerelemente mit Werten aus dem Datenspeicher zu füllen, wenn DataRepeaterItem angezeigt wird oder wenn ein neuer Artikel hinzugefügt wurde.

Wenn die VirtualMode-Eigenschaft auf Falsefestgelegt ist, wird dieses Ereignis nicht ausgelöst.

Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das ItemValueNeeded-Ereignis behandelt wird.Es wird davon ausgegangen, dass Sie ein DataRepeater-Steuerelement mit dem Namen DataRepeater1 , das seinen VirtualMode-Eigenschaft auf Trueverfügt, und dass Sie haben, benannte ein Datenspeicher für eine Datenquelle 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;
        }
    }
}

.NET Framework-Sicherheit

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.