DataRepeater.VirtualMode 属性

项目
09/04/2008

更新：2007 年 11 月

获取或设置一个值，该值指示您是否已经为 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。

示例

下面的代码示例演示如何更改 Form_Load 事件处理程序中 DataRepeater 控件的行为，具体取决于 VirtualMode 属性的值。假定您有一个窗体，其中包含一个名为 DataRepeater1 的 DataRepeater 控件，并且该控件绑定到 Northwind 数据库的 Products 表。

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