DataRepeaterItemEventArgs.DataRepeaterItem-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft das DataRepeaterItem-Objekt ab, das Daten für das DrawItem-Ereignis eines DataRepeater-Steuerelements bereitstellt.

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

Syntax

Public ReadOnly Property DataRepeaterItem As DataRepeaterItem

Dim instance As DataRepeaterItemEventArgs
Dim value As DataRepeaterItem

value = instance.DataRepeaterItem

public DataRepeaterItem DataRepeaterItem { get; }

public:
property DataRepeaterItem^ DataRepeaterItem {
    DataRepeaterItem^ get ();
}

public function get DataRepeaterItem () : DataRepeaterItem

Eigenschaftenwert

Typ: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

Ein Element, das die Daten enthält und auf der ItemTemplate-Eigenschaft des DataRepeater-Steuerelements basiert.

Hinweise

Verwenden Sie das DrawItem-Ereignis zum Ändern der Darstellung von DataRepeaterItem-Objekten, zu denen ein Bildlauf durchgeführt wird.

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. 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.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung des DrawItem-Ereignishandlers zur Durchführung von Änderungen, wenn ein Bildlauf zu einem Element durchgeführt wird. 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.