Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
CanRefreshSchema Property

DataSourceDesigner.CanRefreshSchema Property

Gets a value indicating whether the RefreshSchema method can be called.

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

public virtual bool CanRefreshSchema { get; }

Property Value

Type: System.Boolean
true if the RefreshSchema can be called; otherwise, false. The default is false.



Use the CanRefreshSchema property in a derived class to enable or disable the ability to refresh the schema at design time for a specific data source. If your application requires an invariant data structure and the schema will never change, you want the CanRefreshSchema property to return false.

A design host such as Visual Studio 2005 uses the CanRefreshSchema property to determine whether a command to refresh the schema appears in the action list menu at design time.

In a design host such as Visual Studio 2005, you can see the CanRefreshSchema property in action by completing the following process:

  1. On your page, place a SqlDataSource or an AccessDataSource control.

  2. In Design view, on the action list, click Configure.

  3. Remove a few fields from the data source.

  4. On the action list, click Refresh Schema.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0
© 2015 Microsoft