Właściwość DataRepeater.ItemTemplate —
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.
Zobacz też
Informacje
Przestrzeń nazw Microsoft.VisualBasic.PowerPacks
Inne zasoby
Wprowadzenie do formantu DataRepeater (Visual Studio)
Porady: zmienianie wyglądu formantu DataRepeater (Visual Studio)