This documentation is archived and is not being maintained.

DataSourceDesigner Class

Provides design-time support in a design host for the DataSourceControl class.

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

[SecurityPermissionAttribute(SecurityAction::Demand, Flags = SecurityPermissionFlag::UnmanagedCode)]
public ref class DataSourceDesigner : public ControlDesigner, 
	IDataSourceDesigner

The DataSourceDesigner class is the base class for data source designers, such as the SqlDataSourceDesigner, AccessDataSourceDesigner, and ObjectDataSourceDesigner classes. If you create a new data source control, you might also want to create a custom control designer for your control and derive it from the DataSourceDesigner class.

The DataSourceDesigner class has two event methods: the OnDataSourceChanged and OnSchemaRefreshed methods. Both of these events can be temporarily disabled with the SuppressDataSourceEvents method, which sets the SuppressingDataSourceEvents property. The event methods can be enabled again with the ResumeDataSourceEvents method.

There are two static methods that you can use to evaluate the equivalency of schemas or views without creating an instance of the class:

Notes to Inheritors:

To provide commands for the action list menu at design time in a derived class, you must override the ActionLists property to return a custom DesignerActionListCollection object with custom items that are derived from the DesignerActionList object.

The following code example shows how to use a custom data source control with several other small custom classes, as listed in the following table.

Custom class

Derived from

CustomDataSource

ObjectDataSource

CustomDataSourceDesigner

DataSourceDesigner

CustomDataSourceView

ObjectDataSourceView

CustomDesignDataSourceView

DesignerDataSourceView

BookListViewSchema

IDataSourceViewSchema

CustomIDFieldSchema

IDataSourceFieldSchema

CustomTitleFieldSchema

IDataSourceFieldSchema

BookItem (A two-field data structure.)

After compiling the code example, open the .aspx page in Design view and then set the DataSourceID property to the ID of the custom data source control.

No code example is currently available or this language may not be supported.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

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
Show: