DataRepeater.ItemTemplate-Eigenschaft

Artikel
10/24/2012

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

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

Syntax

'Declaration
<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

function get ItemTemplate () : DataRepeaterItem

Eigenschaftswert

Typ: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Ein Objekt, das das Lay-out und die Darstellung von Elementen im DataRepeater-Steuerelement bestimmt.

Hinweise

Verwenden Sie die ItemTemplate-Eigenschaft, um Eigenschaften festzulegen, die die Laufzeit DataRepeater Darstellung aller Elemente in einem Steuerelement bestimmen.Tatsächlich legen Sie Eigenschaften der DataRepeaterItem-Objekte fest, die zur Laufzeit erstellt werden.Die Elemente, die Sie in DataRepeater zur Laufzeit finden, werden von diesem Objekt kopiert, während sie einen Bildlauf in der Ansicht durchgeführt werden.

Zur Entwurfszeit wenn Sie im Abschnitt DataRepeater auswählen, der die Steuerelemente enthält, enthält das Eigenschaftenfenster Eigenschaften für ItemTemplate.Zum Beispiel wird das Festlegen der BackColor-Eigenschaft ItemTemplate zu Red alle Elemente in DataRepeater , mit einem roten Hintergrund angezeigt wird.

Zur Laufzeit wenn Sie die Eigenschaften ItemTemplateändern, müssen Sie die BeginResetItemTemplate-Methode aufrufen, bevor Sie die Eigenschaften fest, und rufen dann die EndResetItemTemplate-Methode auf, um die Änderungen zu übernehmen.

Die ItemTemplate-Eigenschaft wird auch verwendet, um die Steuerelemente in DataRepeaterItem zur Laufzeit aufzurufen.Zum Beispiel BackColor von TextBox benannte IDTextBoxabzurufen, verwenden Sie 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 Datenbank Northwind 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.
        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;
    }
}

.NET Framework-Sicherheit

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.