Proprietà DataRepeaterItemEventArgs.DataRepeaterItem

Articolo
05/16/2015

Ottiene un DataRepeaterItem che fornisce i dati per l'evento DrawItem di un controllo DataRepeater

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

Sintassi

'Dichiarazione
Public ReadOnly Property DataRepeaterItem As DataRepeaterItem

public DataRepeaterItem DataRepeaterItem { get; }

public:
property DataRepeaterItem^ DataRepeaterItem {
    DataRepeaterItem^ get ();
}

member DataRepeaterItem : DataRepeaterItem with get

function get DataRepeaterItem () : DataRepeaterItem

Valore proprietà

Tipo: Microsoft.VisualBasic.PowerPacks.DataRepeaterItem
Elemento che contiene i dati, basato sulla proprietà di ItemTemplate del controllo DataRepeater .

Note

Utilizzare l'evento di DrawItem per modificare l'aspetto degli oggetti di DataRepeaterItem come vengono scorsi nella visualizzazione.

In fase di esecuzione, le proprietà correlate all'aspetto possono essere impostate in base a condizioni. Ad esempio, in un'applicazione di pianificazione, è possibile modificare il colore di sfondo di un elemento per avvisare gli utenti quando un elemento è scaduto. Se si imposta una proprietà in un'istruzione condizionale come If…Then, è necessario utilizzare anche una clausola di Else per specificare l'aspetto quando la condizione non viene soddisfatta.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il gestore eventi di DrawItem per apportare modifiche quando un elemento viene scorso nella visualizzazione. In questo esempio si suppone di disporre di un controllo DataRepeater 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 altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.