Proprietà DataRepeater.ItemTemplate

Articolo
10/30/2012

ottiene un modello che rappresenta DataRepeaterItem per una proprietà DataRepeater controllare.

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

function get ItemTemplate () : DataRepeaterItem

Valore proprietà

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

Note

utilizzare ItemTemplate proprietà per impostare le proprietà che determinano l'aspetto runtime di tutti gli elementi in DataRepeater controllare.In effetti, in realtà si sta impostando le proprietà di DataRepeaterItem oggetti che verranno creati in fase di esecuzione.Gli elementi visualizzati in DataRepeater in fase di esecuzione vengono copiati da questo oggetto mentre vengono spostati nella visualizzazione.

In fase di progettazione, quando si seleziona la sezione di DataRepeater che contiene i controlli, nella Finestra Proprietà contiene le proprietà di ItemTemplate.Ad esempio, impostare BackColor proprietà di ItemTemplate in Red causa tutti gli elementi in DataRepeater per essere visualizzato con uno sfondo rosso.

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

ItemTemplate la proprietà viene utilizzata per accedere ai controlli in DataRepeaterItem in fase di esecuzione.Ad esempio, recuperare BackColor la proprietà di un oggetto TextBox denominato IDTextBox, utilizzare 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 DataRepeater il controllo include 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 operazioni di personalizzazione.In questo esempio si presuppone che sia a DataRepeater controllare associato alla tabella Products nel 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 ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.