Log4Net was ported over from the stunning and wonderful Log4J. Log4Net supports a large series of Appenders that let you, via a config file, setup a series of destinations for your logging calls. For example, without recompiling your app, you can send Logging information to a Database, or a File, or ASP.NET Tracing. It's very flexible, and easier to use (IMHO) than the Microsoft Logging Application Block.
Additionally there's a concept called a Layout that affects the logging data and either formats or adds extra information like the thread id, username, etc. It's very powerful because your Layout will work for and affect any Appender which makes for nice reuse. So, for example:
<!-- A1 is set to be a ConsoleAppender -->
<appender name="A1" type="log4net.Appender.ConsoleAppender">
<!-- A1 uses PatternLayout -->
<layout type="Corillian.Whatever.Log4NetStuff.CustomPatternLayout, Corillian.Whatever.Log4NetStuff">
<conversionPattern value="%-4timestamp [%thread] %-5level %logger %ndc - %message%newline %G" />
</layout>
</appender>
Here's we're outputing the message, as well as timestamp and thread info.
I wanted to add my OWN CustomPatternLayout and add additionally %whatever tokens. This is done all the time in Log4J.
HOWEVER, in the log4net source, there's a function "FinalizeConverter" in PatternParser.cs that you need to override when you derive you own CustomPatternParser from PatterParser. But, it's not marked virtual. Crap.
It makes total sense though, as everything in Java (where this code was ported from) is virtual and can be overridden. They just forgot to set that log4net 1.2-beta8. That's why it's beta. :)
So, if you make this change in PatternParser line 237:
protected
virtual void FinalizeConverter(char c) ...then you'll be all set to do something like this:
public class CustomPatternLayout : log4net.Layout.PatternLayout
{
public SecurityPatternLayout() : this(log4net.Layout.PatternLayout.DEFAULT_CONVERSION_PATTERN){ //whatever }
public SecurityPatternLayout(string pattern) : base(pattern){ //whatever }
protected override PatternParser CreatePatternParser(string pattern) //where we override and return US as a PatternParser
{
return new SecurityPatternParser(pattern == String.Empty ? log4net.Layout.PatternLayout.DEFAULT_CONVERSION_PATTERN : pattern);
}
}public class SecurityPatternParser : log4net.helpers.PatternParser
{
public SecurityPatternParser(string pattern) : base(pattern){}
protected override void FinalizeConverter(char c)
{
if (c == 'G') //where 'G' is your custom token like %G in the format string
{
AddConverter(new SecurityPatternConvertor()); //Where we add ourselves into the mix, since our token (%G) appears in the format string
}
else base.FinalizeConverter(c);
}public class SecurityPatternConvertor : log4net.helpers.PatternConverter
{
public SecurityPatternConvertor() : base(){}
public SecurityPatternConvertor(FormattingInfo formattingInfo) : base(formattingInfo) {}
override protected string Convert(LoggingEvent loggingEvent)
{
return MessWithThisMessage(loggingEvent.RenderedMessage); //Where we mess with the string however we decide %G should affect it
}
}
Hosting By
This is always a lovely error to get: