DataRepeater.VirtualMode - свойство

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает или задает значение, указывающее, предоставляются ли собственные операции управления данными для элемента управления DataRepeater.

Пространство имен: Microsoft.VisualBasic.PowerPacks
Сборка: Microsoft.VisualBasic.PowerPacks.Vs (в Microsoft.VisualBasic.PowerPacks.Vs.dll)

Синтаксис

'Декларация
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)

Значение свойства

Тип: System.Boolean
Если DataRepeater использует операции управления данными, предоставленные пользователем, значение — true; в противном случае значение — false. Значение по умолчанию — false.

Заметки

Виртуальный режим разработан для работы с большими хранилищами данных. Когда свойство VirtualMode имеет значение True, пользователь создает объект DataRepeater с заданным количеством элементов, а затем обрабатывает событие ItemValueNeeded, чтобы заполнить эти элементы. Для виртуального режима требуется реализация кэша базовых данных, чтобы обработать заполнение, изменение и удаление элементов DataRepeater на основе действий пользователя. Дополнительные сведения о реализации виртуального режима см. в разделе Virtual Mode in the DataRepeater Control.

Примеры

В следующем примере кода показано изменение поведения элемента управления DataRepeater в обработчике событий Form_Load в зависимости от значения свойства VirtualMode. Пример предполагает наличие формы с элементом управления DataRepeater с именем DataRepeater1, который привязан к таблице “Products” базы данных 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;
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.