CurrencyManager.List 属性

获得此 CurrencyManager 的列表。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public ReadOnly Property List As IList
用法
Dim instance As CurrencyManager
Dim value As IList

value = instance.List

public IList List { get; }

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

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

public function get List () : IList

属性值

包含列表的 IList。

备注

由 List 属性返回的对象可以强制转换为任意可以实现 IList 接口的类型。这通常只在已经知道基础列表的类型时使用。例如，如果数据绑定到 DataSet，则基础列表是一个 DataView（可实现 IList）。其他实现此接口的类（这不是一个完整的列表）包括：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。

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

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

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

CurrencyManager 类
CurrencyManager 成员
System.Windows.Forms 命名空间
Position
CurrencyManager.Current 属性
CurrencyManager.Count 属性