Export (0) Print
Expand All

DataSourceControl.GetViewNames Method

Gets a collection of names, representing the list of DataSourceView objects associated with the DataSourceControl control.

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

protected virtual ICollection GetViewNames()

Return Value

Type: System.Collections.ICollection
An ICollection that contains the names of the DataSourceView objects associated with the DataSourceControl.

The ICollection collection of names is the allowable set of values that can be passed to the GetView method.

The ListSourceHelper class, which is used for the DataSourceControl class's IListSource implementation, checks the GetViewNames method for both the ContainsListCollection and GetList calls to determine whether the data source control is associated with one or more data source views. If GetViewNames returns null, which is the default implementation of the method, ContainsListCollection returns false and GetList returns null.

NoteNote:

The DataSourceControl class's default implementation returns null. If you extend the DataSourceControl class, override the GetViewNames method to return a collection of view names.

The following code example demonstrates how a class that extends the DataSourceControl class can override the default implementation, which returns null, to provide a collection of view names. The CsvDataSource class only supports one view; therefore, a collection of one element with the default view name is returned. This code example is part of a larger example provided for the DataSourceControl class.

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

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft