DataRepeater.DrawItem, événement

Article
11/15/2012

Se produit lorsque DataRepeaterItem doit être dessiné.

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

Syntaxe

'Déclaration
Public Event DrawItem As DataRepeaterItemEventHandler

public event DataRepeaterItemEventHandler DrawItem

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

member DrawItem : IEvent<DataRepeaterItemEventHandler,
    DataRepeaterItemEventArgs>

JScript ne prend pas en charge les événements.

Notes

Utilisez cet événement pour modifier l'apparence des objets d'DataRepeaterItem comme ils sont faits défiler dans la vue.

Pendant l'exécution, des propriétés apparence- mises en relation peuvent être définies selon les conditions à mesure que chaque élément est fait défiler dans la vue.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éfini 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.

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

Exemples

Certaines personnalisations courantes du contrôle DataRepeater comprennent l'affichage des lignes dans différentes couleurs et la modification de la couleur d'un champ en fonction d'une condition.L'exemple suivant montre comment effectuer ces personnalisations.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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.