DataRepeaterItem-Klasse

Artikel
08/23/2008

Aktualisiert: November 2007

Wird vom DataRepeater-Steuerelement verwendet, um zur Laufzeit Daten anzuzeigen.

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

Syntax

<DockingAttribute(DockingBehavior.Never)> _
Public Class DataRepeaterItem _
    Inherits Panel

Dim instance As DataRepeaterItem

[DockingAttribute(DockingBehavior.Never)]
public class DataRepeaterItem : Panel

[DockingAttribute(DockingBehavior::Never)]
public ref class DataRepeaterItem : public Panel

public class DataRepeaterItem extends Panel

Hinweise

Das DataRepeater-Steuerelement nutzt DataRepeaterItem-Objekte, um alle Elemente in dem Steuerelement bei einem Bildlauf anzuzeigen. Sobald ein Element beim Bildlauf aus der Ansicht ausgeblendet wird, wird DataRepeaterItem ungültig und durch ein neues DataRepeaterItem-Objekt für das nächste sichtbare Element ersetzt.

Das Layout und die Darstellung jedes Elements basieren auf der ItemTemplate-Eigenschaft. Beim Rendern der einzelnen DataRepeaterItem-Objekte können Sie die Darstellung im DrawItem-Ereignis ändern.

Hinweis:
Sie sollten nur das DataRepeaterItem-Objekt ändern, auf das Sie über das DrawItem-Ereignis zugreifen können. Wenn Sie versuchen, das Objekt außerhalb des Ereignisses zu ändern oder ein neues DataRepeaterItem-Objekt zu erstellen, kann dies unerwartete Ergebnisse zur Folge haben.

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

Vererbungshierarchie

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.ScrollableControl
          System.Windows.Forms.Panel
            Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

Threadsicherheit

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