This documentation is archived and is not being maintained.

HierarchicalDataBoundControlDesigner.PreFilterProperties Method

Note: This method is new in the .NET Framework version 2.0.

Used by the designer to remove properties from or add additional properties to the display in the Properties grid or to shadow properties of the associated control.

Namespace: System.Web.UI.Design.WebControls
Assembly: System.Design (in

protected override void PreFilterProperties (
	IDictionary properties
protected void PreFilterProperties (
	IDictionary properties
protected override function PreFilterProperties (
	properties : IDictionary



A collection implementing the IDictionary of the added and shadowed properties.

Control designers use methods that are derived from the ComponentDesigner.PreFilterProperties method to shadow various control properties with corresponding design-time properties that the designer implements, and to add properties to or remove properties from the Properties grid.

For controls that are derived from the HierarchicalDataBoundControl class, the PreFilterProperties method creates design-time properties to shadow the DataSource and DataSourceID properties.

Notes to Inheritors Override the PreFilterProperties method to add properties to or change the attributes of properties in the design-time property collection. Be sure to call the base method before performing other processing.

The following code example shows how to override the PreFilterProperties method in a class that is inherited from the HierarchicalDataBoundControlDesigner class to change the Properties grid of the HierarchicalDataBoundControl control at design time. The example makes the NamingContainer property visible in the Properties grid.

// Shadow the control properties with design-time properties.
protected override void PreFilterProperties(IDictionary properties)
    string namingContainer = "NamingContainer";

    // Call the base method first.

    // Make the NamingContainery visible in the Properties grid.
    PropertyDescriptor selectProp =
    properties[namingContainer] =
            selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0