DataRepeater.VirtualMode (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece un valor que indica si ha proporcionado sus propias operaciones de administración de datos para el control DataRepeater.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

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)

Valor de propiedad

Tipo: System.Boolean

true si DataRepeater utiliza las operaciones de administración de datos proporcionadas; en caso contrario, false. El valor predeterminado es false.

Comentarios

El modo virtual está diseñado para grandes almacenes de datos. Cuando la propiedad VirtualMode está establecida en True, crea DataRepeater con un número fijo de elementos y, a continuación, administra el evento ItemValueNeeded para rellenar los elementos. El modo virtual requiere implementar una caché de datos subyacente para controlar el llenado, la edición y la eliminación de elementos DataRepeater a partir de las acciones del usuario. Para obtener más información sobre cómo implementar en modo virtual, vea Virtual Mode in the DataRepeater Control.

Ejemplos

El ejemplo de código siguiente muestra cómo cambiar el comportamiento de un control DataRepeater en el controlador de eventos Form_Load, en función del valor de la propiedad VirtualMode. Se supone que tiene un formulario que contiene un control DataRepeater denominado DataRepeater1 que está enlazado a la tabla Products de la base de datos 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;
}

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.