DataRepeater.DrawItem-Ereignis

Artikel
08/23/2008

Aktualisiert: November 2007

Wird ausgelöst, wenn ein DataRepeaterItem gezeichnet werden muss.

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

Syntax

Public Event DrawItem As DataRepeaterItemEventHandler

Dim instance As DataRepeater
Dim handler As DataRepeaterItemEventHandler

AddHandler instance.DrawItem, handler

public event DataRepeaterItemEventHandler DrawItem

public:
 event DataRepeaterItemEventHandler^ DrawItem {
    void add (DataRepeaterItemEventHandler^ value);
    void remove (DataRepeaterItemEventHandler^ value);
}

JScript unterstützt keine Ereignisse.

Hinweise

Mit diesem Ereignis können Sie die Darstellung von DataRepeaterItem-Objekten während eines Bildlaufs ändern.

Zur Laufzeit können darstellungsbezogene Eigenschaften basierend auf Bedingungen festgelegt werden, während ein Bildlauf auf die einzelnen Elemente durchgeführt wird. 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. Wenn Sie eine Eigenschaft in einer Bedingungsanweisung wie If…Then festlegen, müssen Sie mit einer Else-Klausel die Darstellung angeben, die verwendet wird, wenn die Bedingung nicht erfüllt wird.

Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.

Beispiele

Zu den häufigsten Anpassungen für das DataRepeater-Steuerelement gehören die Anzeige der Zeilen in unterschiedlichen Farben und die Änderung der Farbe eines Felds auf Basis einer Bedingung. Das folgende Beispiel veranschaulicht, wie diese Anpassungen vorgenommen werden. In diesem Beispiel wird davon ausgegangen, dass Sie über ein DataRepeater-Steuerelement verfügen, das an die Products-Tabelle in der Northwind-Datenbank 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.
        DataRepeater1.ItemTemplate.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.
        dataRepeater1.ItemTemplate.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;
    }
}

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.