XmlConfiguratorConfigure Method (ILoggerRepository, FileInfo)Apache log4net™ SDK Documentation
Configures the ILoggerRepository 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(
	ILoggerRepository repository,
	FileInfo configFile
)

Parameters

repository
Type: log4net.RepositoryILoggerRepository
The repository to configure.
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(log4net.Repository.ILoggerRepository,System.IO.FileInfo)"]

Remarks

The configuration file must be valid XML. It must contain at least one element called log4net that holds the 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