DataRepeater.VirtualMode-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft einen Wert ab, der angibt, ob für das DataRepeater-Steuerelement eigene Datenverwaltungsvorgänge bereitgestellt wurden, oder legt diesen fest.

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

Syntax

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)

Eigenschaftenwert

Typ: System.Boolean

true, wenn DataRepeater von Ihnen bereitgestellte Datenverwaltungsvorgänge verwendet, andernfalls false. Die Standardeinstellung ist false.

Hinweise

Der virtuelle Modus wurde für große Datenspeicher konzipiert. Wenn die VirtualMode-Eigenschaft auf True festgelegt ist, können Sie ein DataRepeater-Steuerelement mit einer festen Anzahl von Elementen erstellen und dann das ItemValueNeeded-Ereignis verarbeiten, um die Zellen zu füllen. Der virtuelle Modus erfordert die Implementierung eines zugrunde liegenden Datencaches, um das Füllen, Bearbeiten und Löschen von DataRepeater-Elementen basierend auf den Benutzeraktionen zu verarbeiten. Weitere Informationen zum Implementieren des virtuellen Modus finden Sie unter Virtual Mode in the DataRepeater Control.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das Verhalten eines DataRepeater-Steuerelements im Form_Load-Ereignishandler in Abhängigkeit von dem Wert der VirtualMode-Eigenschaft ändern. Es wird davon ausgegangen, dass ein Formular vorhanden ist, das ein DataRepeater-Steuerelement mit dem Namen DataRepeater1 enthält, welches an die Products-Tabelle in der Northwind-Datenbank gebunden ist.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.