DataRepeater.ItemTemplate-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft eine Vorlage ab, die das DataRepeaterItem für ein DataRepeater-Steuerelement darstellt.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

<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

Eigenschaftenwert

Typ: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem

Ein Objekt, das das Layout und die Darstellung von Elementen im DataRepeater-Steuerelement bestimmt.

Hinweise

Mit der ItemTemplate-Eigenschaft können Sie Merkmale festlegen, die die Darstellung aller Elemente in einem DataRepeater-Steuerelement zur Laufzeit bestimmen. Sie legen hierbei die Eigenschaften der DataRepeaterItem-Objekte fest, die zur Laufzeit erstellt werden. Die Elemente, die zur Laufzeit im DataRepeater-Steuerelement angezeigt werden, werden aus diesem Objekt kopiert, wenn ein Bildlauf zu ihnen durchgeführt wird.

Wenn Sie zur Entwurfszeit den DataRepeater-Abschnitt mit den Steuerelementen auswählen, enthält das Eigenschaftenfenster die Eigenschaften für ItemTemplate. Wenn Sie z. B. die BackColor-Eigenschaft von ItemTemplate auf Red festlegen, werden alle Elemente im DataRepeater-Steuerelement mit einem roten Hintergrund angezeigt.

Wenn Sie zur Laufzeit die Eigenschaften von ItemTemplate ändern, müssen Sie die BeginResetItemTemplate-Methode aufrufen, bevor Sie die Eigenschaften festlegen. Rufen Sie anschließend die EndResetItemTemplate-Methode auf, um die Änderungen zu übergeben.

Die ItemTemplate-Eigenschaft wird auch verwendet, um zur Laufzeit auf die Steuerelemente in DataRepeaterItem zuzugreifen. Um beispielsweise die BackColor-Eigenschaft eines TextBox-Steuerelements mit dem Namen IDTextBox abzurufen, verwenden Sie den folgenden Code:

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

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

Beispiele

Zu den häufigsten Anpassungen für das DataRepeater-Steuerelement gehören die Anzeige der Zeilen in unterschiedlichen Farben und die Änderung der Farbe eines Felds auf Basis einer Bedingung. Das folgende Beispiel veranschaulicht, wie diese Anpassungen vorgenommen werden. In diesem Beispiel wird davon ausgegangen, dass Sie über ein DataRepeater-Steuerelement verfügen, das an die Products-Tabelle in der Northwind-Datenbank gebunden ist.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.