Classe DataRepeaterItemValueEventArgs

Artigo
10/26/2012

Fornece dados para o ItemValueNeeded e ItemValuePushed eventos.

Hierarquia de herança

System.Object
System.EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs

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

Sintaxe

'Declaração
Public Class DataRepeaterItemValueEventArgs _
    Inherits EventArgs

public class DataRepeaterItemValueEventArgs : EventArgs

public ref class DataRepeaterItemValueEventArgs : public EventArgs

type DataRepeaterItemValueEventArgs =  
    class
        inherit EventArgs
    end

public class DataRepeaterItemValueEventArgs extends EventArgs

O tipo DataRepeaterItemValueEventArgs expõe os membros a seguir.

Construtores

	Nome	Descrição
	DataRepeaterItemValueEventArgs	Inicializa uma nova instância da classe DataRepeaterItemValueEventArgs.

Superior

Propriedades

	Nome	Descrição
	Control	Obtém o controle filho de um DataRepeaterItem que está aumentando também o ItemValueNeeded ou ItemValuePushed evento.
	ItemIndex	Obtém o índice da DataRepeaterItem que contém o controle que está aumentando também o ItemValueNeeded ou ItemValuePushed evento.
	PropertyName	Obtém o nome da propriedade ligados a dados do controle que está aumentando também a uma ItemValueNeeded ou ItemValuePushed evento.
	Value	Obtém o valor da propriedade que foi alterado para elevar um ItemValueNeeded ou ItemValuePushed evento.

Superior

Métodos

	Nome	Descrição
	Equals	determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
	Finalize	Permite que um objeto tentar liberar recursos e realizar outras operações de limpeza antes de ser recuperados pela coleta de lixo. (Herdado de Object.)
	GetHashCode	Serve como uma função de hash para um tipo específico. (Herdado de Object.)
	GetType	Obtém Type da instância atual. (Herdado de Object.)
	MemberwiseClone	Cria uma cópia superficial de Objectatual. (Herdado de Object.)
	ToString	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object.)

Superior

Comentários

No modo virtual, use o ItemValueNeeded controla o evento para preencher o filho da ItemTemplate com valores de seus dados armazenar 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;
        }
    }
}

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.