Classe DataRepeaterItemValueEventArgs

Articolo
05/16/2015

Fornisce i dati per gli eventi ItemValueNeeded e ItemValuePushed.

Gerarchia di ereditarietà

Object
EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

'Dichiarazione
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

Il tipo DataRepeaterItemValueEventArgs espone i seguenti membri.

Costruttori

	Nome	Descrizione
	DataRepeaterItemValueEventArgs	Inizializza una nuova istanza della classe DataRepeaterItemValueEventArgs.

In alto

Proprietà

	Nome	Descrizione
	Control	Ottiene il controllo figlio di un oggetto DataRepeaterItem che genera l'evento ItemValueNeeded o ItemValuePushed.
	ItemIndex	Ottiene l'indice dell'oggetto DataRepeaterItem che contiene il controllo che sta generando l'evento ItemValueNeeded o ItemValuePushed.
	PropertyName	Ottiene il nome della proprietà associata a dati del controllo che genera un evento ItemValueNeeded o ItemValuePushed.
	Value	Ottiene il valore della proprietà che è stato modificato per generare un evento ItemValuePushed o ItemValueNeeded.

In alto

Metodi

	Nome	Descrizione
	Equals	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection. (Ereditato da Object)
	GetHashCode	Funge da funzione hash predefinita. (Ereditato da Object)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	MemberwiseClone	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Note

In modalità virtuale, utilizzare l'evento ItemValueNeeded per popolare i controlli figlio di ItemTemplate con i valori dall'archivio dati quando DataRepeaterItem visualizzare o quando un nuovo elemento verrà aggiunto.

Utilizzare l'evento di ItemValuePushed per salvare le modifiche ai valori dei controlli figlio nell'archivio dati.

Quando la proprietà di VirtualMode è impostata su False, questi eventi non vengono generati.

Esempi

Nell'esempio riportato di seguito viene illustrato come gestire l'evento ItemValueNeeded. Si presuppone che esista un controllo di DataRepeater denominato DataRepeater1 che presenta la proprietà di VirtualMode a True. che il codice sarà simile all'esempio seguente, che fa riferimento a un'origine dati denominata 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;
        }
    }
}