NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

IConfigMerger Interface

Implemented by platform and application developers that need to define their own merging logic when computing merges across a configuration file hierarchy.

IConfigMerger

[Visual Basic]
Public Interface IConfigMerger
[C#]
public interface IConfigMerger
[C++]
public __gc __interface IConfigMerger

[JScript] In JScript, you can use the interfaces in the NGWS frameworks, but you cannot define your own.

Classes that Implement IConfigMerger

Class Description
Interceptors.ListAppend Used by the configuration system to merge configuration information from multiple configuration files by appending the configuration info from the child file after the information from the parent file.
Interceptors.ListMerge Used by the configuration system to merge configuration information from multiple configuration files by replacing any matching configuration info from the parent file with information from the child file.
Interceptors.ListPrepend Used by the configuration system to merge configuration information from multiple configuration files by inserting the configuration info from the child file before the information from the parent file.
Interceptors.PropertyOverride Used by the configuration system to merge configuration information from multiple configuration files by changing a single configuration info to carry the properties from the innermost configuration file. This effectively implements configuration inheritance from parent to child.

Remarks

Merges configuration information for a parent node with configuration information from a child node.

The ConfigManager invokes a merge interceptor (based on declarations in mwiring.xml) repeatedly for each pair of configuration files in the configuration file hierarchy.

A typical merge interceptor

The Configuration System provides a set of commonly used merge interceptors (Interceptors.PropertyOverride, Interceptors.ListMerge, Interceptors.ListAppend, Interceptors.ListPrepend) that can be used to merge custom configuration information.

Refer to Interceptors.IConfigTransformer for an example of declaring a merge interceptor in conjunction with a hierarchy interceptor.

Requirements

Namespace: System.Configuration.Interceptors

Assembly: System.Configuration.dll

See Also

IConfigMerger Members | System.Configuration.Interceptors Namespace