DataSourceControl.GetViewNames 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取名称的集合,表示与 DataSourceControl 控件关联的 DataSourceView 对象的列表。
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
返回
ICollection,包含与 DataSourceControl 关联的 DataSourceView 对象的名称。
示例
下面的代码示例演示扩展 DataSourceControl 类的类如何重写默认实现(该实现返回 null
),以提供视图名称的集合。 类 CsvDataSource
仅支持一个视图;因此,返回具有默认视图名称的一个元素的集合。 此代码示例是为 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 方法的允许值集。
ListSourceHelper用于类实现的 IListSource 类DataSourceControl检查 GetViewNames 方法是否同时IListSource.ContainsListCollection调用 和 IListSource.GetList 以确定数据源控件是否与一个或多个数据源视图相关联。 如果 GetViewNames 返回 null
,这是方法的默认实现, IListSource.ContainsListCollection 则 false
返回 并 IListSource.GetList 返回 null
。
注意
类 DataSourceControl 的默认实现返回 null
。 如果扩展 DataSourceControl 类,请 GetViewNames 重写 方法以返回视图名称的集合。