CurrencyManager.List Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a lista para este 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
Valor da propriedade
Um IList que contém a lista.
Exemplos
O exemplo de código a seguir permite que os usuários editem um conjunto de registros, mas não adicionem novos. No caso Navigate de um DataGrid controle, o IList retornado pela List propriedade é convertido em uma DataView variável. A propriedade AllowNew do DataView é definida como 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
Comentários
O objeto retornado pela List propriedade pode ser convertido em qualquer tipo que implemente a IList interface. Isso será comumente usado quando você souber o tipo da lista subjacente. Por exemplo, se você estiver associado a dados a um DataSet, a lista subjacente será um DataView (que implementa IList). Outras classes que implementam a interface (esta não é uma lista completa) incluem Array, ArrayListe CollectionBase.
A forma como você usa a List propriedade depende da classe que implementa a IList interface . Por exemplo, você pode usar a List propriedade para determinar o nome da lista. Se a fonte de dados implementar a ITypedList interface, você poderá usar o GetListName método para retornar o nome da tabela atual. Isso é mostrado no código C# abaixo:
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));
}