Classe DataRepeaterItem

Articolo
09/12/2008

Aggiornamento: novembre 2007

Oggetto utilizzato dal controllo DataRepeater per visualizzare i dati in fase di esecuzione.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

<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

Note

Il controllo DataRepeater utilizza oggetti DataRepeaterItem per visualizzare ogni elemento nel controllo man mano che viene scorso nella visualizzazione. Non appena un elemento fuoriesce dall'aria di scorrimento della visualizzazione, l'oggetto DataRepeaterItem viene invalidato e sostituito da un nuovo oggetto DataRepeaterItem per il successivo elemento visibile.

Il layout e l'aspetto di ogni elemento sono basati sulla proprietà ItemTemplate. Quando viene eseguito il rendering di ogni oggetto DataRepeaterItem, è possibile modificarne l'aspetto nell'evento DrawItem.

Nota:
È necessario modificare solo l'oggetto DataRepeaterItem accessibile dall'evento DrawItem. Il tentativo di modificare tale oggetto al di fuori dell'evento o di creare un nuovo oggetto DataRepeaterItem può produrre risultati imprevisti.

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare il gestore dell'evento DrawItem per apportare modifiche quando un elemento viene scorso nella visualizzazione. In questo esempio si suppone di disporre di un controllo DataRepeater associato alla tabella Products nel database Northwind.

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