DataRepeater.ItemTemplate, propriété

Article
09/04/2008

Mise à jour : novembre 2007

Obtient un modèle qui représente le DataRepeaterItem d'un contrôle DataRepeater.

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

Syntaxe

<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem

Dim instance As DataRepeater
Dim value As DataRepeaterItem

value = instance.ItemTemplate

[BrowsableAttribute(false)]
public DataRepeaterItem ItemTemplate { get; }

[BrowsableAttribute(false)]
public:
property DataRepeaterItem^ ItemTemplate {
    DataRepeaterItem^ get ();
}

public function get ItemTemplate () : DataRepeaterItem

Valeur de propriété

Type : Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

Objet qui détermine la disposition et l'apparence des éléments dans le contrôle DataRepeater.

Notes

Utilisez la propriété ItemTemplate pour définir des propriétés qui déterminent l'apparence de tous les éléments d'un contrôle DataRepeater au moment de l'exécution. En fait, vous définissez des propriétés des objets DataRepeaterItem qui seront créés au moment de l'exécution. Les éléments que vous voyez dans le DataRepeater au moment de l'exécution sont copiés depuis cet objet à mesure qu'ils défilent dans l'affichage.

Au moment du design, lorsque vous sélectionnez la section du DataRepeater qui contient les contrôles, la fenêtre Propriétés contient des propriétés pour le ItemTemplate. Par exemple, le définition de la propriété BackColor du ItemTemplate sur Red provoque l'affichage de tous les éléments DataRepeater avec un arrière-plan rouge.

Au moment de l'exécution, si vous modifiez les propriétés du ItemTemplate, vous devez appeler la méthode BeginResetItemTemplate avant de définir les propriétés, puis appelez la méthode EndResetItemTemplate pour valider les modifications.

La propriété ItemTemplate est également utilisée pour accéder aux contrôles dans le DataRepeaterItem au moment de l'exécution. Par exemple, pour récupérer le BackColor d'un TextBox nommé IDTextBox, vous devez utiliser le code suivant :

Dim BC As Color = _
 DataRepeater1.ItemTemplate.Controls(IDTextBox.Name).BackColor

color BC = dataRepeater1.ItemTemplate.Controls["IDTextBox"].BackColor;

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

Autorisations

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.