DataRepeaterItemEventArgs.DataRepeaterItem, propriété

Article
05/16/2015

Obtient un DataRepeaterItem qui fournit les données pour l'événement DrawItem d'un contrôle DataRepeater

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
Public ReadOnly Property DataRepeaterItem As DataRepeaterItem

public DataRepeaterItem DataRepeaterItem { get; }

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

member DataRepeaterItem : DataRepeaterItem with get

function get DataRepeaterItem () : DataRepeaterItem

Valeur de propriété

Type : Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Élément qui contient les données, en fonction de la propriété de ItemTemplate du contrôle de DataRepeater .

Notes

Utilisez l'événement d'DrawItem pour modifier l'apparence des objets d'DataRepeaterItem lorsqu'ils sont effectuées défilement dans la vue.

Des propriétés liées à l'apparence peuvent être définies en fonction de conditions au moment de l'exécution. Par exemple, dans le cas d'une application de planification, vous pouvez modifier la couleur d'arrière-plan d'un élément afin de prévenir les utilisateurs que la date d'échéance est dépassée. Si vous définissez une propriété dans une instruction conditionnelle telle qu' If…Then, vous devez également utiliser une clause d'Else pour spécifier l'apparence lorsque la condition n'est pas remplie.

Exemples

L'exemple suivant montre comment utiliser le gestionnaire d'événements DrawItem pour apporter des modifications lorsqu'un élément est fait défiler dans la vue. Cet exemple suppose qu'il existe un contrôle DataRepeater lié à la table Products de la base de données 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.
        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;
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.