CurrencyManager.List Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient la liste de ce CurrencyManager.

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

public System.Collections.IList List { get; }

member this.List : System.Collections.IList

Public ReadOnly Property List As IList

Valeur de propriété

IList

IList qui contient la liste.

Exemples

L’exemple de code suivant permet aux utilisateurs de modifier un ensemble d’enregistrements, mais pas d’en ajouter de nouveaux. Dans le Navigate cas d’un DataGrid contrôle, le IList retourné par la List propriété est converti en variable DataView . La propriété AllowNew du DataView a la valeur 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 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 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

Remarques

L’objet retourné par la List propriété peut être casté dans n’importe quel type qui implémente l’interface IList . Elle est couramment utilisée lorsque vous connaissez le type de la liste sous-jacente. Par exemple, si vous êtes lié aux données à un DataSet, la liste sous-jacente est un DataView (qui implémente IList). Les autres classes qui implémentent l’interface (il ne s’agit pas d’une liste complète) incluent Array, ArrayListet CollectionBase.

La façon dont vous utilisez la List propriété dépend de la classe qui implémente l’interface IList . Par exemple, vous pouvez utiliser la List propriété pour déterminer le nom de la liste. Si la source de données implémente l’interface ITypedList , vous pouvez utiliser la GetListName méthode pour retourner le nom de la table active. Cela est illustré dans le code C# ci-dessous :

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

Voir aussi

• Position
• Current
• Count