DataRepeater.ItemTemplate-Eigenschaft

Artikel
05/16/2015

Ruft eine Vorlage ab, die die DataRepeaterItem eines DataRepeater-Steuerelements 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 with get

function get ItemTemplate () : DataRepeaterItem

Eigenschaftswert

Typ: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Ein Objekt, das das Layout und die Darstellung von Elementen in dem DataRepeater-Steuerelement definiert.

Hinweise

Verwenden der ItemTemplate -Eigenschaft zum Festlegen von Eigenschaften, die bestimmen, die zur Laufzeitdarstellung aller Elemente in einem DataRepeater Steuerelement. Gültig, Sie werden tatsächlich Festlegen der Eigenschaften der DataRepeaterItem Laufzeit der Objekte, die am erstellt werden. Die Elemente, die Sie in finden Sie in der DataRepeater zur Laufzeit kopiert werden von diesem Objekt, wie sie bei einem Bildlauf sichtbar sind.

Zur Entwurfszeit bei den Teil Auswahl der DataRepeater , die die Steuerelemente enthält, das Eigenschaftenfenster enthält Eigenschaften für die ItemTemplate. Z. B. die BackColor Eigenschaft der ItemTemplate auf Red bewirkt, dass alle Elemente in der DataRepeater mit einem roten Hintergrund angezeigt werden soll.

Zur Laufzeit werden, wenn Sie die Eigenschaften ändern die ItemTemplate, rufen Sie die BeginResetItemTemplate -Methode vor dem Festlegen der Eigenschaften fest und rufen dann die EndResetItemTemplate -Methode, um die Änderungen zu übernehmen.

Die ItemTemplate -Eigenschaft wird auch zum Zugreifen auf die Steuerelemente in der DataRepeaterItem zur Laufzeit. Z. B. zum Abrufen der BackColor von einem TextBox mit dem Namen IDTextBox, verwenden Sie den folgenden Code:

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

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

Beispiele

Einige allgemeinen Anpassungen für die DataRepeater -Steuerelement gehören die Anzeige der Zeilen in unterschiedlichen Farben und das Ändern der Farbe eines Felds auf Grundlage einer Bedingung. Im folgenden Beispiel wird veranschaulicht, wie diese Anpassungen vorgenommen. In diesem Beispiel wird vorausgesetzt, dass Sie ein DataRepeater -Steuerelement, 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.
        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.