Proprietà DataRepeater.VirtualMode

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ottiene o imposta un valore che indica se sono state specificate operazioni di gestione dei dati personalizzate per il controllo DataRepeater.

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

Sintassi

Public Property VirtualMode As Boolean

Dim instance As DataRepeater
Dim value As Boolean

value = instance.VirtualMode

instance.VirtualMode = value

public bool VirtualMode { get; set; }

public:
property bool VirtualMode {
    bool get ();
    void set (bool value);
}

public function get VirtualMode () : boolean
public function set VirtualMode (value : boolean)

Valore proprietà

Tipo: System.Boolean

true se DataRepeater utilizza le operazioni di gestione dei dati specificate; in caso contrario, false. Il valore predefinito è false.

Note

La modalità virtuale è progettata per essere utilizzata con archivi dati di grandi dimensioni. Quando la proprietà VirtualMode è impostata su True, è possibile creare un oggetto DataRepeater con un determinato numero di elementi e gestire l'evento ItemValueNeeded per popolare tali elementi. La modalità virtuale richiede l'implementazione di una cache di dati sottostante per gestire la compilazione, la modifica e l'eliminazione degli elementi DataRepeater in base alle azioni dell'utente. Per ulteriori informazioni sull'implementazione della modalità virtuale, vedere Virtual Mode in the DataRepeater Control.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come modificare il comportamento di un controllo DataRepeater nel gestore dell'evento Form_Load, a seconda del valore della proprietà VirtualMode. Nell'esempio si suppone di disporre di un form che contiene un controllo DataRepeater denominato DataRepeater1, associato alla tabella Products del database Northwind.

' If the DataRepeater is in virtual mode, 
' do not allow adds or deletes.
If DataRepeater1.VirtualMode = True Then
    DataRepeater1.AllowUserToAddItems = False
    DataRepeater1.AllowUserToDeleteItems = False
    ' Disable the Add button.
    ProductsBindingNavigator.AddNewItem.Enabled = False
    ' Disable the Delete button.
    ProductsBindingNavigator.DeleteItem.Enabled = False
End If

// If the DataRepeater is in virtual mode, 
// do not allow adds or deletes.
if (dataRepeater1.VirtualMode == true)
{
    dataRepeater1.AllowUserToAddItems = false;
    dataRepeater1.AllowUserToDeleteItems = false;
    // Disable the Add button.
    productsBindingNavigator.AddNewItem.Enabled = false;
    // Disable the Delete button.
    productsBindingNavigator.DeleteItem.Enabled = false;
}

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.