XmlConfiguratorAttribute Class

Apache log4net™ SDK Documentation

Assembly level attribute to configure the XmlConfigurator.

Inheritance Hierarchy

System Attribute
    log4net.Config ConfiguratorAttribute
      log4net.Config XmlConfiguratorAttribute
        log4net.Config DOMConfiguratorAttribute

Namespace: log4net.Config
Assembly: log4net (in log4net.dll) Version: 1.2.15.0 (1.2.15.0)

Syntax

C++

Copy to Clipboard Print

[SerializableAttribute]
public class XmlConfiguratorAttribute : ConfiguratorAttribute

[SerializableAttribute]
public class XmlConfiguratorAttribute : ConfiguratorAttribute

<SerializableAttribute>
Public Class XmlConfiguratorAttribute 
	Inherits ConfiguratorAttribute

<SerializableAttribute>
Public Class XmlConfiguratorAttribute 
	Inherits ConfiguratorAttribute

[SerializableAttribute]
public ref class XmlConfiguratorAttribute : public ConfiguratorAttribute

[SerializableAttribute]
public ref class XmlConfiguratorAttribute : public ConfiguratorAttribute

Remarks

This attribute may only be used at the assembly scope and can only be used once per assembly.

Use this attribute to configure the XmlConfigurator without calling one of the [M:XmlConfigurator.Configure()] methods.

If neither of the ConfigFile or ConfigFileExtension properties are set the configuration is loaded from the application's .config file. If set the ConfigFile property takes priority over the ConfigFileExtension property. The ConfigFile property specifies a path to a file to load the config from. The path is relative to the application's base directory; Online BaseDirectory. The ConfigFileExtension property is used as a postfix to the assembly file name. The config file must be located in the application's base directory; Online BaseDirectory. For example in a console application setting the ConfigFileExtension to config has the same effect as not specifying the ConfigFile or ConfigFileExtension properties.

The Watch property can be set to cause the XmlConfigurator to watch the configuration file for changes.

Note
Log4net will only look for assembly level configuration attributes once. When using the log4net assembly level attributes to control the configuration of log4net you must ensure that the first call to any of the LoggerManager methods is made from the assembly with the configuration attributes. If you cannot guarantee the order in which log4net calls will be made from different assemblies you must use programmatic configuration instead, i.e. call the [M:XmlConfigurator.Configure()] method directly.

Note

Log4net will only look for assembly level configuration attributes once. When using the log4net assembly level attributes to control the configuration of log4net you must ensure that the first call to any of the LoggerManager methods is made from the assembly with the configuration attributes.

If you cannot guarantee the order in which log4net calls will be made from different assemblies you must use programmatic configuration instead, i.e. call the [M:XmlConfigurator.Configure()] method directly.