Classe DataRepeaterItemValueEventArgs

Artigo
05/17/2015

Fornece dados para o ItemValueNeeded e ItemValuePushed eventos.

Hierarquia de herança

Object
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	Determines whether the specified object is equal to the current object. (Herdado de Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Herdado de Object.)
	GetHashCode	Serves as the default hash function. (Herdado de Object.)
	GetType	Gets the Type of the current instance. (Herdado de Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Herdado de Object.)
	ToString	Returns a string that represents the current object. (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.