DataRepeater.VirtualMode プロパティ

[アーティクル]
08/22/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;
}