This documentation is archived and is not being maintained.

LoginDesigner.PreFilterProperties Method

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 System.Design.dll)

protected override void PreFilterProperties(
	IDictionary properties
)

Parameters

properties
Type: System.Collections.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.

If a LayoutTemplate property has been defined for the Login control, the PreFilterProperties sets the BrowsableAttribute attribute of properties that do not apply when templated to false so those properties do not appear in the Properties grid.

Notes to Inheritors

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

The following code sample creates a class derived from LoginDesigner, and overrides the PreFilterProperties method to change the Properties grid of a Login 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)
{
    // Call the base method first.
    base.PreFilterProperties(properties);

    // Make the NamingContainer visible in the Properties grid.
    PropertyDescriptor selectProp = 
        (PropertyDescriptor)properties["NamingContainer"];
    properties["NamingContainer"] =
        TypeDescriptor.CreateProperty(selectProp.ComponentType, 
            selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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