DataSourceControl.GetViewNames Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает коллекцию имен, представляющих список объектов 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
Возвращаемое значение
ICollection, содержащая имена объектов DataSourceView, связанных с DataSourceControl.
Примеры
В следующем примере кода показано, как класс, расширяющий 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 , используемый для DataSourceControl реализации класса IListSource , проверяет GetViewNames метод для IListSource.ContainsListCollection вызовов и , IListSource.GetList чтобы определить, связан ли элемент управления источником данных с одним или несколькими представлениями источников данных. Если GetViewNames возвращает null
значение , который является реализацией метода по умолчанию, IListSource.ContainsListCollection возвращается false
и IListSource.GetList возвращается null
.
Примечание
DataSourceControl Реализация класса по умолчанию возвращает null
. При расширении DataSourceControl класса переопределите GetViewNames метод , чтобы вернуть коллекцию имен представлений.