DataRepeater.VirtualMode 屬性

發行項
08/21/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。

範例

在下列程式碼範例中，會示範如何根據 VirtualMode 屬性的值，在 Form_Load 事件處理常式中變更 DataRepeater 控制項的行為。這個範例假設您的表單上有一個名為 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;
}