DataRepeaterItemValueEventArgs-Klasse

Artikel
10/24/2012

Stellt Daten für das ItemValueNeeded-Ereignis und das ItemValuePushed-Ereignis bereit.

Vererbungshierarchie

System.Object
System.EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs

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

Syntax

'Declaration
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

Der DataRepeaterItemValueEventArgs-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	DataRepeaterItemValueEventArgs	Initialisiert eine neue Instanz der DataRepeaterItemValueEventArgs-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Control	Ruft das untergeordnete Steuerelement aus DataRepeaterItem ab, das das ItemValueNeeded oder ItemValuePushed-Ereignis auslöst.
	ItemIndex	Ruft den Index DataRepeaterItem ab, der dem Steuerelement, das das ItemValueNeeded oder ItemValuePushed-Ereignis auslöst.
	PropertyName	Ruft den Namen der datengebundenen Eigenschaft des Steuerelements ab, das ein ItemValueNeeded oder ItemValuePushed-Ereignis auslöst.
	Value	Ruft den Eigenschaftswert ab, das geändert wurde, um ein ItemValueNeeded oder ItemValuePushed-Ereignis auszulösen.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Hinweise

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

Verwenden Sie das ItemValuePushed-Ereignis, um Änderungen an untergeordneten Steuerelementwerten dem Datenspeicher zu speichern.

Wenn die VirtualMode-Eigenschaft auf Falsefestgelegt ist, werden diese Ereignisse nicht ausgelöst.

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 True.hat, dem folgenden Beispiel ähnelt dem Code, der für eine Datenquelle handelt, die Employeesbenannt ist.

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.