Proprietà DataRepeater.ItemTemplate

Articolo
05/16/2015

Ottiene un modello che rappresenta l'oggetto DataRepeaterItem per un controllo DataRepeater.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

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

Valore proprietà

Tipo: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Oggetto che determina il layout e l'aspetto degli elementi nel controllo DataRepeater.

Note

Utilizzare il ItemTemplate proprietà per impostare le proprietà che determinano l'aspetto in fase di esecuzione di tutti gli elementi in un DataRepeater controllo. In effetti, effettivamente impostano le proprietà del DataRepeaterItem gli oggetti che verranno creati in fase di esecuzione. Gli elementi presenti nel DataRepeater in fase di esecuzione vengono copiati da questo oggetto come lo scorrimento in vista.

In fase di progettazione, quando si seleziona la sezione del DataRepeater che contiene i controlli, la finestra proprietà contiene le proprietà per il ItemTemplate. Ad esempio, impostando il BackColor proprietà del ItemTemplate a Red , tutti gli elementi nel DataRepeater siano visualizzati con uno sfondo rosso.

In fase di esecuzione, se si modificano le proprietà del ItemTemplate, è necessario chiamare il BeginResetItemTemplate metodo prima di impostare le proprietà e quindi chiamare il EndResetItemTemplate metodo per eseguire il commit delle modifiche.

Il ItemTemplate proprietà viene utilizzata anche per accedere ai controlli la DataRepeaterItem in fase di esecuzione. Ad esempio, per recuperare il BackColor di un TextBox denominato IDTextBox, si utilizzerebbe il codice seguente:

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

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

Esempi

Alcune personalizzazioni comuni per la DataRepeater controllo includono la visualizzazione delle righe in colori alternati e la modifica del colore di un campo in base a una condizione. Nell'esempio seguente viene illustrato come eseguire queste personalizzazioni. Questo esempio si presuppone di avere un DataRepeater controllo associato alla tabella Products del database 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;
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.