DataRepeaterItemValueEventArgs-Klasse

Artikel
05/16/2015

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

Vererbungshierarchie

Object
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 eines DataRepeaterItem ab, das das ItemValueNeeded oder ItemValuePushed-Ereignis auslöst.
	ItemIndex	Ruft den Index des DataRepeaterItem ab, das das Steuerelement enthält, 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, der 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 die Standardhashfunktion. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie vom 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 neues Element hinzugefügt wird.

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

Wenn die Eigenschaft VirtualMode auf False festgelegt ist, werden diese Ereignisse nicht ausgelöst.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das ItemValueNeeded-Ereignis behandelt wird. Sie wird davon ausgegangen, dass Sie ein DataRepeater-Steuerelement, das dem Namen DataRepeater1, dessen VirtualMode-Eigenschaft auf True. festgelegt ist, das Code, der dem folgenden Beispiel ähnelt, das für eine Datenquelle ist, die Employees genannt wird.

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.