DataSourceControl.GetViewNames メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataSourceView コントロールに関連付けられているDataSourceControlオブジェクトの一覧を表す名前のコレクションを取得します。
protected:
virtual System::Collections::ICollection ^ GetViewNames();
protected virtual System.Collections.ICollection GetViewNames();
abstract member GetViewNames : unit -> System.Collections.ICollection
override this.GetViewNames : unit -> System.Collections.ICollection
Protected Overridable Function GetViewNames () As ICollection
返品
DataSourceControlに関連付けられたDataSourceView オブジェクトの名前を格納するICollection。
例
次のコード例は、 DataSourceControl クラスを拡張するクラスが、ビュー名のコレクションを提供するために、 nullを返す既定の実装をオーバーライドする方法を示しています。
CsvDataSource クラスは 1 つのビューのみをサポートするため、既定のビュー名を持つ 1 つの要素のコレクションが返されます。 このコード例は、 DataSourceControl クラスに提供されるより大きな例の一部です。
// The ListSourceHelper class calls GetList, which
// calls the DataSourceControl.GetViewNames method.
// Override the original implementation to return
// a collection of one element, the default view name.
protected override ICollection GetViewNames() {
ArrayList al = new ArrayList(1);
al.Add(CsvDataSourceView.DefaultViewName);
return al as ICollection;
}
}
' The ListSourceHelper class calls GetList, which
' calls the DataSourceControl.GetViewNames method.
' Override the original implementation to return
' a collection of one element, the default view name.
Protected Overrides Function GetViewNames() As ICollection
Dim al As New ArrayList(1)
al.Add(CsvDataSourceView.DefaultViewName)
Return CType(al, ICollection)
End Function 'GetViewNames
End Class
注釈
ICollection名前のコレクションは、GetView メソッドに渡すことができる値の許容されるセットです。
DataSourceControl クラスのIListSource実装に使用される ListSourceHelper クラスは、IListSource.ContainsListCollectionとIListSource.GetListの両方の呼び出しについてGetViewNames メソッドをチェックして、データ ソース コントロールが 1 つ以上のデータ ソース ビューに関連付けられているかどうかを判断します。
GetViewNamesがメソッドの既定の実装であるnullを返す場合、IListSource.ContainsListCollectionはfalseを返し、IListSource.GetListはnullを返します。
Note
DataSourceControl クラスの既定の実装は、nullを返します。
DataSourceControl クラスを拡張する場合は、GetViewNames メソッドをオーバーライドしてビュー名のコレクションを返します。