Evento DataRepeater.ItemValueNeeded

Artigo
10/26/2012

Ocorre quando o VirtualMode propriedade estiver definida como True e um novo valor para um controle filho de um DataRepeaterItem é necessária.

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

Sintaxe

'Declaração
Public Event ItemValueNeeded As DataRepeaterItemValueEventHandler

public event DataRepeaterItemValueEventHandler ItemValueNeeded

public:
 event DataRepeaterItemValueEventHandler^ ItemValueNeeded {
    void add (DataRepeaterItemValueEventHandler^ value);
    void remove (DataRepeaterItemValueEventHandler^ value);
}

member ItemValueNeeded : IEvent<DataRepeaterItemValueEventHandler,
    DataRepeaterItemValueEventArgs>

JScript não oferece suporte a eventos.

Comentários

No modo virtual, use este evento para preencher os controles filho com os valores do seus dados armazenar quando um DataRepeaterItem é exibido ou quando um novo item for adicionado.

Quando o VirtualMode propriedade estiver definida como False, este evento não é gerado.

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

Exemplos

O exemplo a seguir demonstra como manipular o ItemValueNeeded evento.Ele pressupõe que você tenha um DataRepeater controle denominado DataRepeater1 que tem seu VirtualMode propriedade definida como True, e se você tem um armazenamento de dados para uma fonte de dados denominado Employees.

Private Sub DataRepeater1_ItemValueNeeded(
    ByVal sender As Object, 
    ByVal e As Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs
  ) Handles DataRepeater1.ItemValueNeeded
    If e.ItemIndex < Employees.Count Then
        Select Case e.Control.Name
            Case "txtFirstName"
                e.Value = Employees.Item(e.ItemIndex + 1).firstName
            Case "txtLastName"
                e.Value = Employees.Item(e.ItemIndex + 1).lastName
        End Select
    End If
End Sub

private void dataRepeater1_ItemValueNeeded(object sender, Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs e)
{
    if (e.ItemIndex < Employees.Count)
    {
        switch (e.Control.Name)
        {
            case "txtFirstName":
                e.Value = Employees[e.ItemIndex + 1].firstName;
                break;
            case "txtLastName":
                e.Value = Employees[e.ItemIndex + 1].lastName;
                break;
        }
    }
}

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.