Export (0) Print
Expand All

GridViewDesigner.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
)
protected void PreFilterProperties (
	IDictionary properties
)
protected override function PreFilterProperties (
	properties : IDictionary
)
Not applicable.

Parameters

properties

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 the GridView control, the PreFilterProperties method sets the BrowsableAttribute object of the Columns property to false when the control is in template mode. This is so a column that is in template mode cannot be deleted using the Fields dialog box.

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 example shows how to override the PreFilterProperties method in a class that is inherited from the GridViewDesigner to change the Properties grid of the GridView control at design time. The example makes the Page 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 Page visible in the Properties grid.
    PropertyDescriptor selectProp = 
        (PropertyDescriptor)properties["Page"];
    properties["Page"] =
        TypeDescriptor.CreateProperty(selectProp.ComponentType, 
            selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2015 Microsoft