XmlConfigurator Configure 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

C#
VB
C++
F#
Copy

    public static ICollection Configure(
    	ILoggerRepository repository,
    	FileInfo configFile
    )

    Public Shared Function Configure (
    	repository As ILoggerRepository,
    	configFile As FileInfo
    ) As ICollection

    public:
    static ICollection^ Configure(
    	ILoggerRepository^ repository,
    	FileInfo^ configFile
    )

    static member Configure :
            repository : ILoggerRepository *
            configFile : FileInfo -> ICollection

#### Parameters

repository
  Type: log4net.Repository
  ILoggerRepository
  The repository to configure.
configFile
  Type: System.IO
  FileInfo
  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:

Copy

    <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#
Copy

    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 :

Copy

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

See Also

#### Reference

XmlConfigurator Class
Configure Overload
log4net.Config Namespace