DataRepeaterItemEventArgs-Klasse

Artikel
10/24/2012

Stellt Daten für das DrawItem-Ereignis bereit.

Vererbungshierarchie

System.Object
System.EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs

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

Syntax

'Declaration
Public Class DataRepeaterItemEventArgs _
    Inherits EventArgs

public class DataRepeaterItemEventArgs : EventArgs

public ref class DataRepeaterItemEventArgs : public EventArgs

type DataRepeaterItemEventArgs =  
    class
        inherit EventArgs
    end

public class DataRepeaterItemEventArgs extends EventArgs

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

Konstruktoren

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

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	DataRepeaterItem	Ruft DataRepeaterItem ab, das die Daten für das DrawItem-Ereignis eines DataRepeater-Steuerelements bereitstellt

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

Verwenden Sie das DrawItem-Ereignis, um die Darstellung der DataRepeaterItem-Objekten zu ändern, wie sie in der Ansicht einen Bildlauf durchgeführt werden.

Zur Laufzeit können darstellungsbezogene Eigenschaften basierend auf Bedingungen festgelegt werden.In einer Planungsanwendung können Sie z. B. die Hintergrundfarbe eines Elements ändern, um Benutzer darauf aufmerksam zu machen, dass der Fälligkeitstermin des Elements verstrichen ist.Beim Festlegen einer Eigenschaft in einer Bedingungsanweisung wie If…Theneine Else-Klausel auch verwenden, um das Erscheinungsbild anzugeben, wenn die Bedingung nicht erfüllt wird.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der DrawItem-Ereignishandler verwendet, um Änderungen vorzunehmen, wenn sich ein Element in der Ansicht einen Bildlauf durchgeführt wird.In diesem Beispiel wird davon ausgegangen, dass Sie über ein DataRepeater-Steuerelement verfügen, das an die Products-Tabelle in der Datenbank Northwind gebunden ist.

Private Sub DataRepeater1_DrawItem(
    ByVal sender As Object, 
    ByVal e As Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs
  ) Handles DataRepeater1.DrawItem

    ' Alternate the back color.
    If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then
        ' Apply the secondary back color.
        e.DataRepeaterItem.BackColor = Color.AliceBlue
    Else
        ' Apply the default back color.
        e.DataRepeaterItem.BackColor = Color.White
    End If
    ' Change the color of out-of-stock items to red.
    If e.DataRepeaterItem.Controls(
          UnitsInStockTextBox.Name).Text < 1 Then

        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). 
         BackColor = Color.Red
    Else
        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). 
         BackColor = Color.White
    End If
End Sub

private void dataRepeater1_DrawItem(object sender, 
    Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs e)
{
    // Alternate the back color.
    if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
    // Apply the secondary back color.
    {
        e.DataRepeaterItem.BackColor = Color.AliceBlue;
    }
    else
    {
        // Apply the default back color.
        e.DataRepeaterItem.BackColor = Color.White;
    }
    // Change the color of out-of-stock items to red.
    if (e.DataRepeaterItem.Controls["unitsInStockTextBox"].Text == "0")
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.Red;
    }
    else
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.White;
    }
}

Threadsicherheit

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