Właściwość DataRepeater.ItemTemplate —

Artykuł
05/17/2015

Pobiera szablon, który reprezentuje DataRepeaterItem dla DataRepeater kontroli.

Przestrzeń nazw: Microsoft.VisualBasic.PowerPacks
Zestaw: Microsoft.VisualBasic.PowerPacks.Vs (w Microsoft.VisualBasic.PowerPacks.Vs.dll)

Składnia

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

Wartość właściwości

Typ: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Obiekt, który określa układ i wygląd elementów w DataRepeater kontroli.

Uwagi

Użyj ItemTemplate właściwości można ustawić właściwości, które określają wygląd wszystkie elementy w czasie wykonywania DataRepeater kontroli.W efekcie są faktycznie ustawienie właściwości DataRepeaterItem obiektów, które zostaną utworzone w czasie wykonywania.Elementy, które są wyświetlane w DataRepeater w czasie wykonywania są kopiowane z tego obiektu, ponieważ są one przewijane do widoku.

W czasie projektowania, w przypadku wybrania sekcji DataRepeater zawiera formanty, okno właściwości zawiera właściwości dla ItemTemplate.Na przykład ustawienie BackColor właściwości ItemTemplate do Red powoduje, że wszystkie elementy w DataRepeater mają być wyświetlane na czerwonym tle.

W czasie wykonywania, jeśli zmiana właściwości ItemTemplate, należy wywołać BeginResetItemTemplate metody przed ustawieniem właściwości, a następnie połączenie EndResetItemTemplate metodę, aby zatwierdzić zmiany.

ItemTemplate Jest również używana dostępu do formantów w DataRepeaterItem w czasie wykonywania.Na przykład, aby pobrać BackColor z TextBox o nazwie IDTextBox, należy użyć następującego kodu:

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

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

Przykłady

Niektóre dostosowania wspólne dla DataRepeater kontroli obejmują wiersze są wyświetlane w przełączanie kolory i zmiana koloru pola na podstawie warunku.Poniższy przykład przedstawia sposób wykonać te dostosowania.W tym przykładzie założono, że DataRepeater formant, który jest powiązany z tabeli Produkty w bazie danych 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;
    }
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.