CurrencyManager.List-Eigenschaft

Ruft die Liste für diesen CurrencyManager ab.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public ReadOnly Property List As IList
'Usage
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

Eigenschaftenwert

Eine Instanz von IList, die die Liste enthält.

Hinweise

Das von der List-Eigenschaft zurückgegebene Objekt kann in jeden beliebigen Typ umgewandelt werden, der die IList-Schnittstelle implementiert. Dies wird meist verwendet, wenn der Typ der zugrunde liegenden Liste bekannt ist. Wenn beispielsweise eine Datenbindung zu einem DataSet besteht, ist die zugrunde liegende Liste eine DataView (die IList implementiert). Weitere Klassen, die diese Schnittstelle implementieren, sind unter anderem Array, ArrayList und CollectionBase.

Wie Sie die List-Eigenschaft verwenden, hängt von der Klasse ab, die die IList-Schnittstelle implementiert. Beispielsweise können Sie mithilfe der List-Eigenschaft den Namen der Liste ermitteln. Wenn die Datenquelle die ITypedList-Schnittstelle implementiert, können Sie mit der GetListName-Methode den Namen der aktuellen Tabelle zurückgeben. Dies wird im folgenden C#-Code dargestellt:

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

Beispiel

Im folgenden Codebeispiel können Benutzer die Datensätze einer Datensatzmenge bearbeiten, jedoch keine neuen Datensätze hinzufügen. Im Navigate-Ereignis eines DataGrid-Steuerelements wird die von der List-Eigenschaft zurückgegebene IList in eine DataView-Variable umgewandelt. Die AllowNew-Eigenschaft der DataView ist auf false festgelegt.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

CurrencyManager-Klasse
CurrencyManager-Member
System.Windows.Forms-Namespace
Position
CurrencyManager.Current-Eigenschaft
CurrencyManager.Count-Eigenschaft