Propriedade DataRepeaterItemValueEventArgs.Control

Artigo
10/26/2012

Obtém o controle filho de um DataRepeaterItem que está aumentando também o ItemValueNeeded ou ItemValuePushed evento.

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

Sintaxe

'Declaração
Public ReadOnly Property Control As Control

public Control Control { get; }

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

member Control : Control

function get Control () : Control

Valor de propriedade

Tipo: System.Windows.Forms.Control
O controle que está aumentando o evento.

Comentários

No modo virtual, use o ItemValueNeeded armazenar de evento para preencher os controles filhos com valores dos seus dados quando um DataRepeaterItem é exibido ou quando um novo item for adicionado.

Use o ItemValuePushed evento para salvar as alterações para os valores de controle filho para seu armazenamento de dados.

Quando o VirtualMode propriedade estiver definida como False, esses eventos não são gerados.

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. o código parecerá com o exemplo a seguir, que é para uma fonte de dados denominada 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.