次の方法で共有


DataRepeater.VirtualMode プロパティ

更新 : 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;
}

アクセス許可

  • 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

参照

DataRepeater クラス

DataRepeater メンバ

Microsoft.VisualBasic.PowerPacks 名前空間

その他の技術情報

DataRepeater コントロールの概要 (Visual Studio)

DataRepeater コントロールの仮想モード (Visual Studio)

How to: Disable Adding and Deleting DataRepeater Items