CurrencyManager.List Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Liste für diesen CurrencyManager ab.

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

Eigenschaftswert

IList

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

Beispiele

Im folgenden Codebeispiel können Benutzer eine Reihe von Datensätzen bearbeiten, aber keine neuen hinzufügen. Navigate Im Fall eines DataGrid Steuerelements wird das IList von der List -Eigenschaft zurückgegebene in eine DataView Variable umgewandelt. Für die Eigenschaft AllowNew des DataView wird der Wert false festgelegt.

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

Hinweise

Das von der List -Eigenschaft zurückgegebene Objekt kann in einen beliebigen Typ umgewandelt werden, der die IList -Schnittstelle implementiert. Dies wird häufig verwendet, wenn Sie den Typ der zugrunde liegenden Liste kennen. Wenn Sie z. B. an datengebunden DataSetsind, ist die zugrunde liegende Liste eine DataView (die implementiert IList). Andere Klassen, die die -Schnittstelle implementieren (dies ist keine vollständige Liste), sind Array, ArrayListund CollectionBase.

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

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

Gilt für:

Freigeben über