XmlConfiguratorConfigure Method (FileInfo)Apache log4net™ SDK Documentation
Configures log4net using the specified configuration file.

Namespace: log4net.Config
Assembly: log4net (in log4net.dll) Version: 2.0.8.0-.NET 4.0
Syntax

public static ICollection Configure(
	FileInfo configFile
)

Parameters

configFile
Type: System.IOFileInfo
The XML file to load the configuration from.

Return Value

Type: ICollection

[Missing <returns> documentation for "M:log4net.Config.XmlConfigurator.Configure(System.IO.FileInfo)"]

Remarks

The configuration file must be valid XML. It must contain at least one element called log4net that holds the log4net configuration data.

The log4net configuration file can possible be specified in the application's configuration file (either MyAppName.exe.config for a normal application on Web.config for an ASP.NET application).

The first element matching <configuration> will be read as the configuration. If this file is also a .NET .config file then you must specify a configuration section for the log4net element otherwise .NET will complain. Set the type for the section handler to IgnoreSectionHandler, for example:

<configSections><section name="log4net" type="System.Configuration.IgnoreSectionHandler" /></configSections>

Examples

The following example configures log4net using a configuration file, of which the location is stored in the application's configuration file :
C#
using log4net.Config;
using System.IO;
using System.Configuration;

...

XmlConfigurator.Configure(new FileInfo(ConfigurationSettings.AppSettings["log4net-config-file"]));

In the .config file, the path to the log4net can be specified like this :

<configuration><appSettings><add key="log4net-config-file" value="log.config" /></appSettings></configuration>
See Also

Reference