CurrencyManager.List プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CurrencyManager.List プロパティ

この CurrencyManager のリストを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 List As IList

Visual Basic (使用法)

Dim instance As CurrencyManager
Dim value As IList

value = instance.List

public IList List { get; }

C++

public:
property IList^ List {
    IList^ get ();
}

/** @property */
public IList get_List ()

JScript

public function get List
 () : IList

プロパティ値
リストを格納している IList。

解説

List プロパティによって返されたオブジェクトは、IList インターフェイスを実装する任意の型にキャストできます。この操作は、通常、基になるリストの型が既知である場合に使用します。たとえば、DataSet にデータバインドされている場合、基になるリストは IList を実装する DataView です。このインターフェイス (これは完全なリストではありません) を実装するその他のクラスには、Array、ArrayList、および CollectionBase があります。

List プロパティの使用方法は、IList インターフェイスを実装するクラスによって異なります。たとえば、List プロパティを使用して、リストの名前を確認できます。データソースが ITypedList インターフェイスを実装する場合は、GetListName メソッドを使用すると、現在のテーブルの名前を返すことができます。上記の例を次の C# コードに示します。

 private void PrintCurrentListName(DataGrid
 myDataGrid){ 
    CurrencyManager myCM = (CurrencyManager) 
    BindingContext[myDataGrid.DataSource, myDataGrid.DataMember]; 
    IList myList = myCM.List; 
    ITypedList thisList = (ITypedList) myList; 
    Console.WriteLine(thisList.GetListName(null)); 
 }

使用例

レコードのセットの編集を許可し、新しいレコードの追加は許可しないコード例を次に示します。DataGrid コントロールの Navigate イベントで、List プロパティによって返された IList が DataView 変数にキャストされます。DataView の AllowNew プロパティが false に設定されます。

Visual Basic

Private Sub Grid_Navigate(sender As
 Object, e As NavigateEventArgs)
   If e.Forward Then
      Dim ds As DataSet = CType(grid.DataSource,
 DataSet)
      Dim cm As CurrencyManager = _
      CType(BindingContext(ds,"Customers.CustOrders"),
 CurrencyManager)
      ' Cast the IList to a DataView to set the AllowNew property.
      Dim dv As DataView = CType(cm.List, DataView)
      dv.AllowNew = false
   End If
End Sub

private void Grid_Navigate(object sender, NavigateEventArgs
 e){
   if (e.Forward ){
      DataSet ds = (DataSet) grid.DataSource;
      CurrencyManager cm  = 
      (CurrencyManager)BindingContext[ds,"Customers.CustOrders"];
      // Cast the IList to a DataView to set the AllowNew property.
      DataView dv  = (DataView) cm.List;
      dv.AllowNew = false;
   }
}

C++

private:
   void Grid_Navigate( Object^ /*sender*/, NavigateEventArgs^
 e )
   {
      if ( e->Forward )
      {
         DataSet^ ds = dynamic_cast<DataSet^>(grid->DataSource);
         CurrencyManager^ cm = dynamic_cast<CurrencyManager^>(BindingContext[ds,
 "Customers::CustOrders"]);
         
         // Cast the IList* to a DataView to set the AllowNew property.
         DataView^ dv = dynamic_cast<DataView^>(cm->List);
         dv->AllowNew = false;
      }
   }

private void GridNavigate(Object sender, NavigateEventArgs
 e)
{
    if (e.get_Forward()) {
        DataSet ds = (DataSet)grid.get_DataSource();
        CurrencyManager cm = (CurrencyManager)get_BindingContext().
            get_Item(ds, "Customers.CustOrders");

        // Cast the IList to a DataView to set the AllowNew property.
        DataView dv = (DataView)(cm.get_List());
        dv.set_AllowNew(false);
    }
} //GridNavigate