DataRepeater.ItemTemplate, propriété

Article
05/16/2015

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

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

Syntaxe

'Déclaration
<BrowsableAttribute(False)> _
Public ReadOnly Property ItemTemplate As DataRepeaterItem

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

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

[<BrowsableAttribute(false)>]
member ItemTemplate : DataRepeaterItem with get

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 du contrôle de DataRepeater.

Notes

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

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

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

Le ItemTemplate propriété est également utilisée pour accéder aux contrôles dans les DataRepeaterItem en cours d'exécution. Par exemple, pour récupérer le BackColor d'un TextBox nommé IDTextBox, vous utiliseriez 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 DataRepeater contrôle comprennent l'affichage des lignes dans des couleurs alternées et modifier la couleur d'un champ en fonction d'une condition. L'exemple suivant montre comment effectuer ces personnalisations. Cet exemple suppose que vous avez un DataRepeater contrôle qui est lié à la table Products dans 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.