public class ColoredConsoleAppender : AppenderSkeleton

Public Class ColoredConsoleAppender
	Inherits AppenderSkeleton

public ref class ColoredConsoleAppender : public AppenderSkeleton

type ColoredConsoleAppender =  
    class
        inherit AppenderSkeleton
    end

The ColoredConsoleAppender type exposes the following members.

	Name	Description
	ColoredConsoleAppender	Initializes a new instance of the ColoredConsoleAppender class.
	ColoredConsoleAppender(ILayout)	Obsolete. Initializes a new instance of the ColoredConsoleAppender class with the specified layout.
	ColoredConsoleAppender(ILayout, Boolean)	Obsolete. Initializes a new instance of the ColoredConsoleAppender class with the specified layout.

	Name	Description
	ErrorHandler	Gets or sets the IErrorHandler for this appender. (Inherited from AppenderSkeleton.)
	FilterHead	The filter chain. (Inherited from AppenderSkeleton.)
	Layout	Gets or sets the ILayout for this appender. (Inherited from AppenderSkeleton.)
	Name	Gets or sets the name of this appender. (Inherited from AppenderSkeleton.)
	RequiresLayout	This appender requires a log4net.Layout to be set. (Overrides AppenderSkeletonRequiresLayout.)
	Target	Target is the value of the console output stream. This is either "Console.Out" or "Console.Error".
	Threshold	Gets or sets the threshold Level of this appender. (Inherited from AppenderSkeleton.)

	Name	Description
	ActivateOptions	Initialize the options for this appender (Overrides AppenderSkeletonActivateOptions.)
	AddFilter	Adds a filter to the end of the filter chain. (Inherited from AppenderSkeleton.)
	AddMapping	Add a mapping of level to color - done by the config file
	Append(LoggingEvent)	Append a bulk array of logging events. (Inherited from AppenderSkeleton.)
	Append(LoggingEvent)	This method is called by the DoAppend(LoggingEvent) method. (Overrides AppenderSkeletonAppend(LoggingEvent).)
	ClearFilters	Clears the filter list for this appender. (Inherited from AppenderSkeleton.)
	Close	Closes the appender and release resources. (Inherited from AppenderSkeleton.)
	DoAppend(LoggingEvent)	Performs threshold checks and invokes filters before delegating actual logging to the subclasses specific [M:Append(LoggingEvent)] method. (Inherited from AppenderSkeleton.)
	DoAppend(LoggingEvent)	Performs threshold checks and invokes filters before delegating actual logging to the subclasses specific [M:Append(LoggingEvent[])] method. (Inherited from AppenderSkeleton.)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	FilterEvent	Test if the logging event should we output by this appender (Inherited from AppenderSkeleton.)
	Finalize	Finalizes this appender by calling the implementation's Close method. (Inherited from AppenderSkeleton.)
	Flush	Flushes any buffered log data. (Inherited from AppenderSkeleton.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	IsAsSevereAsThreshold	Checks if the message level is below this appender's threshold. (Inherited from AppenderSkeleton.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnClose	Is called when the appender is closed. Derived classes should override this method if resources need to be released. (Inherited from AppenderSkeleton.)
	PreAppendCheck	Called before [M:Append(LoggingEvent)] as a precondition. (Inherited from AppenderSkeleton.)
	RenderLoggingEvent(LoggingEvent)	Renders the LoggingEvent to a string. (Inherited from AppenderSkeleton.)
	RenderLoggingEvent(TextWriter, LoggingEvent)	Renders the LoggingEvent to a string. (Inherited from AppenderSkeleton.)
	ToString	Returns a String that represents the current Object. (Inherited from Object.)

	Name	Description
	ConsoleError	The Target to use when writing to the Console standard error output stream.
	ConsoleOut	The Target to use when writing to the Console standard output stream.

ColoredConsoleAppender appends log events to the standard output stream or the error output stream using a layout specified by the user. It also allows the color of a specific type of message to be set.

By default, all output is written to the console's standard output stream. The Target property can be set to direct the output to the error stream.

NOTE: This appender writes directly to the application's attached console not to the System.Console.Out or System.Console.ErrorTextWriter. The System.Console.Out and System.Console.Error streams can be programmatically redirected (for example NUnit does this to capture program output). This appender will ignore these redirections because it needs to use Win32 API calls to colorize the output. To respect these redirections the ConsoleAppender must be used.

When configuring the colored console appender, mapping should be specified to map a logging level to a color. For example:

<mapping><level value="ERROR" /><foreColor value="White" /><backColor value="Red, HighIntensity" /></mapping><mapping><level value="DEBUG" /><backColor value="Green" /></mapping>

The Level is the standard log4net logging level and ForeColor and BackColor can be any combination of the following values:

• Blue -
• Green -
• Red -
• White -
• Yellow -
• Purple -
• Cyan -
• HighIntensity -

Reference