PropertyFilterOptions Enumeration


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Specifies which properties should be reported by type descriptors, specifically the GetProperties method. This enumeration is used to specify the value of the PropertyFilterAttribute.Filter property.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:   System.ComponentModel
Assembly:  WindowsBase (in WindowsBase.dll)

public enum PropertyFilterOptions

Member nameDescription

Return all properties.


Return only those properties that are not valid given the current context of the object. See Remarks.


Return no properties


Return only those properties that have local values currently set.


Return only those properties whose local values are not set, or do not have properties set in an external expression store (such as binding or deferred resource).


Return any property that is valid on the object in the current scope. See Remarks.

This filter mechanism is only implemented by the custom DependencyPropertyDescriptor for DependencyObject.

Invalid and Valid are relevant only for attached properties. The validity of a property is determined by working with the following attributes: AttachedPropertyBrowsableForChildrenAttribute , AttachedPropertyBrowsableForTypeAttribute, AttachedPropertyBrowsableWhenAttributePresentAttribute which define the intended scope of the attached property in the object tree once the XAML is loaded. Designer applications that populate property grids and include attached properties in the grid must examine the value or presence of these attributes and the relative position of the current element versus either a parent or child element that "owns" the attached property. The owner-setter relationship together with the attribute values and PropertyFilterOptions will define whether a given attached property that is set on an element is valid or invalid.

.NET Framework
Available since 3.0
Return to top