Evento DataRepeater.DrawItem

Artigo
10/26/2012

Ocorre quando um DataRepeaterItem deve ser desenhada.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
Public Event DrawItem As DataRepeaterItemEventHandler

public event DataRepeaterItemEventHandler DrawItem

public:
 event DataRepeaterItemEventHandler^ DrawItem {
    void add (DataRepeaterItemEventHandler^ value);
    void remove (DataRepeaterItemEventHandler^ value);
}

member DrawItem : IEvent<DataRepeaterItemEventHandler,
    DataRepeaterItemEventArgs>

JScript não oferece suporte a eventos.

Comentários

Use este evento para alterar a aparência de DataRepeaterItem objetos como eles são colocados na exibição.

Em tempo de execução, propriedades relacionadas à aparência podem ser definidas com base nas condições como cada item é colocada na exibição.Por exemplo, em um aplicativo de agendamento, você pode alterar a cor de plano de fundo de um item para avisar os usuários quando um item está vencido.Se você definir uma propriedade em uma instrução condicional, tais como If…Then, você também deve usar um Else cláusula para especificar a aparência quando a condição não for atendida.

Para obter mais informações sobre como manipular eventos, consulte Consumindo eventos.

Exemplos

Algumas personalizações comuns para o DataRepeater controle incluem exibir as linhas em cores alternadas e alterando a cor de um campo com base em uma condição.O exemplo a seguir mostra como realizar essas personalizações.Este exemplo presume que você tenha um DataRepeater controle está acoplado à tabela Produtos no banco de dados 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;
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.