This documentation is archived and is not being maintained.

ConfigurationSection.ShouldSerializePropertyInTargetVersion Method

Indicates whether the specified property should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework.

Namespace:  System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)

protected internal virtual bool ShouldSerializePropertyInTargetVersion(
	ConfigurationProperty property,
	string propertyName,
	FrameworkName targetFramework,
	ConfigurationElement parentConfigurationElement


Type: System.Configuration.ConfigurationProperty
The ConfigurationProperty object that is a candidate for serialization.
Type: System.String
The name of the ConfigurationProperty object as it occurs in XML.
Type: System.Runtime.Versioning.FrameworkName
The target version of the .NET Framework.
Type: System.Configuration.ConfigurationElement
The parent element of the property.

Return Value

Type: System.Boolean
true if the property should be serialized; otherwise, false.

Each configuration section that is created for the .NET Framework version 4 and later versions must explicitly override this method and return true, but only if the specified property is valid for the specified version of the .NET Framework. Existing configuration sections that were created for earlier versions of the .NET Framework do not have to be changed.

The base type contains a default implementation of this method that always returns true. If you implement a configuration section and you do not override this method, by default all configuration properties that are contained in the configuration section will be serialized for all framework versions.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, 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.