Construtor DataRepeaterItemValueEventArgs

Artigo
10/26/2012

Inicializa uma nova instância da classe DataRepeaterItemValueEventArgs.

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

Sintaxe

'Declaração
Public Sub New ( _
    itemIndex As Integer, _
    control As Control, _
    propertyName As String, _
    value As Object _
)

public DataRepeaterItemValueEventArgs(
    int itemIndex,
    Control control,
    string propertyName,
    Object value
)

public:
DataRepeaterItemValueEventArgs(
    int itemIndex, 
    Control^ control, 
    String^ propertyName, 
    Object^ value
)

new : 
        itemIndex:int * 
        control:Control * 
        propertyName:string * 
        value:Object -> DataRepeaterItemValueEventArgs

public function DataRepeaterItemValueEventArgs(
    itemIndex : int, 
    control : Control, 
    propertyName : String, 
    value : Object
)

Parâmetros

itemIndex
Tipo: System.Int32
O índice da DataRepeaterItem que contém o controle que está aumentando o evento.

control
Tipo: System.Windows.Forms.Control

propertyName
Tipo: System.String
A propriedade do controle que foi alterado ou que necessita dos dados.

value
Tipo: System.Object
O valor da propriedade que foi alterado.

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;
        }
    }
}

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.