XmlLoggingConfiguration Class

A class for configuring NLog through an XML configuration file (App.config style or App.nlog style). Parsing of the XML file is also implemented in this class.

Inheritance Hierarchy

SystemObject
  NLog.ConfigLoggingConfiguration
    NLog.ConfigLoggingConfigurationParser
      NLog.ConfigXmlLoggingConfiguration

Namespace: NLog.Config
Assembly: NLog (in NLog.dll) Version: 5.3.4+73d83d3161d31288ca5c554cc50d27b6bed5f28b

Syntax

Copy

public class XmlLoggingConfiguration : LoggingConfigurationParser

Public Class XmlLoggingConfiguration
	Inherits LoggingConfigurationParser

Dim instance As XmlLoggingConfiguration

type XmlLoggingConfiguration =  
    class
        inherit LoggingConfigurationParser
    end

The XmlLoggingConfiguration type exposes the following members.

Constructors

	Name	Description
	XmlLoggingConfiguration(String)	Initializes a new instance of the XmlLoggingConfiguration class.
	XmlLoggingConfiguration(XmlReader)	Initializes a new instance of the XmlLoggingConfiguration class.
	XmlLoggingConfiguration(String, LogFactory)	Initializes a new instance of the XmlLoggingConfiguration class.
	XmlLoggingConfiguration(XmlReader, String)	Initializes a new instance of the XmlLoggingConfiguration class.
	XmlLoggingConfiguration(XmlReader, String, LogFactory)	Initializes a new instance of the XmlLoggingConfiguration class.

Top

Properties

	Name	Description
	AllTargets	Gets all targets. (Inherited from LoggingConfiguration.)
	AppConfig	Gets the default LoggingConfiguration object by parsing the application configuration file (app.exe.config).
	AutoReload	Gets or sets a value indicating whether all of the configuration files should be watched for changes and reloaded automatically when changed.
	ConfiguredNamedTargets	Gets a collection of named targets specified in the configuration. (Inherited from LoggingConfiguration.)
	DefaultCultureInfo	Gets or sets the default culture info to use as FormatProvider. (Inherited from LoggingConfiguration.)
	FileNamesToWatch	Gets the collection of file names which should be watched for changes by NLog. This is the list of configuration files processed. If the autoReload attribute is not set it returns empty collection. (Overrides LoggingConfigurationFileNamesToWatch.)
	InitializeSucceeded	Did the Initialize(XmlReader, String, Boolean) Succeeded? true= success, false= error, null = initialize not started yet.
	LogFactory	Gets the factory that will be configured (Inherited from LoggingConfiguration.)
	LoggingRules	Gets the collection of logging rules. (Inherited from LoggingConfiguration.)
	Variables	Gets the variables defined in the configuration or assigned from API (Inherited from LoggingConfiguration.)

Top

Methods

	Name	Description
	AddRule(LoggingRule)	Add a rule object. (Inherited from LoggingConfiguration.)
	AddRule(LogLevel, LogLevel, Target, String)	Add a rule with min- and maxLevel. (Inherited from LoggingConfiguration.)
	AddRule(LogLevel, LogLevel, String, String)	Add a rule with min- and maxLevel. (Inherited from LoggingConfiguration.)
	AddRule(LogLevel, LogLevel, Target, String, Boolean)	Add a rule with min- and maxLevel. (Inherited from LoggingConfiguration.)
	AddRuleForAllLevels(String, String)	Add a rule for all loglevels. (Inherited from LoggingConfiguration.)
	AddRuleForAllLevels(Target, String)	Add a rule for all loglevels. (Inherited from LoggingConfiguration.)
	AddRuleForAllLevels(Target, String, Boolean)	Add a rule for all loglevels. (Inherited from LoggingConfiguration.)
	AddRuleForOneLevel(LogLevel, Target, String)	Add a rule for one loglevel. (Inherited from LoggingConfiguration.)
	AddRuleForOneLevel(LogLevel, String, String)	Add a rule for one loglevel. (Inherited from LoggingConfiguration.)
	AddRuleForOneLevel(LogLevel, Target, String, Boolean)	Add a rule for one loglevel. (Inherited from LoggingConfiguration.)
	AddTarget(Target)	Registers the specified target object. The name of the target is read from Name. (Inherited from LoggingConfiguration.)
	AddTarget(String, Target)	Registers the specified target object under a given name. (Inherited from LoggingConfiguration.)
	CreateFromXmlString(String)	Parse XML string as NLog configuration
	CreateFromXmlString(String, LogFactory)	Parse XML string as NLog configuration
	FindRuleByName	Lookup the logging rule with matching RuleName (Inherited from LoggingConfiguration.)
	FindTargetByName(String)	Finds the target with the specified name. (Inherited from LoggingConfiguration.)
	Install	Installs target-specific objects on current system. (Inherited from LoggingConfiguration.)
	LoadConfig	Loads NLog configuration from provided config section (Inherited from LoggingConfigurationParser.)
	OnConfigurationAssigned	Notify the configuration when Configuration has been assigned / unassigned. (Inherited from LoggingConfiguration.)
	ParseNLogSection	Parses a single config section within the NLog-config (Overrides LoggingConfigurationParserParseNLogSection(ILoggingConfigurationElement).)
	PrepareForReload	Allow this new configuration to capture state from the old configuration (Inherited from LoggingConfiguration.)
	Reload	Re-reads the original configuration file and returns the new LoggingConfiguration object. (Overrides LoggingConfigurationReload.)
	RemoveRuleByName	Removes the specified named logging rule with matching RuleName (Inherited from LoggingConfiguration.)
	RemoveTarget	Removes the specified named target. (Inherited from LoggingConfiguration.)
	ToString	Returns a string that represents the current object. (Overrides LoggingConfigurationToString.)
	Uninstall	Uninstalls target-specific objects from current system. (Inherited from LoggingConfiguration.)

Top

Remarks

- This class is thread-safe..ToList() is used for that purpose. - Update TemplateXSD.xml for changes outside targets

Reference

NLog.Config Namespace