DataRepeater.VirtualMode, propriété

Article
09/04/2008

Mise à jour : novembre 2007

Obtient ou définit une valeur qui indique si vous avez fourni vos propres opérations de gestion de données pour le contrôle DataRepeater.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

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)

Valeur de propriété

Type : System.Boolean

true si le DataRepeater utilise des opérations de gestion de données que vous fournissez ; sinon, false. La valeur par défaut est false.

Notes

Le mode virtuel est conçu pour être utilisé avec des magasins de données volumineux. Lorsque la propriété VirtualMode a la valeur True, vous créez un DataRepeater avec un nombre déterminé d'éléments, puis gérez l'événement ItemValueNeeded pour remplir les éléments. Le mode virtuel requiert l'implémentation d'un cache de données sous-jacent pour gérer le remplissage, la modification et la suppression d'éléments DataRepeater en fonction des actions de l'utilisateur. Pour plus d'informations sur l'implémentation du mode virtuel, consultez Virtual Mode in the DataRepeater Control.

Exemples

L'exemple de code suivant montre comment modifier le comportement d'un contrôle DataRepeater dans le gestionnaire d'événements Form_Load en fonction de la valeur de la propriété VirtualMode. Il suppose que vous disposez d'un formulaire qui contient un contrôle DataRepeater nommé DataRepeater1 et qui est lié à la table Products de la base de données 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;
}

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.