[This is preliminary documentation and is subject to change.]

Discards log messages. Used mainly for debugging and benchmarking.

Namespace:  NLog.Targets
Assembly:  NLog (in NLog.dll) Version: 2.0.1.0

Syntax

C#
public sealed class NullTarget : TargetWithLayout
Visual Basic (Declaration)
Public NotInheritable Class NullTarget _
	Inherits TargetWithLayout
Visual Basic (Usage)
Dim instance As NullTarget

Examples

To set up the target in the configuration file, use the following syntax:

CopyXML
 1<?xml version="1.0" ?>
 2<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
 3      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 4    <targets>
 5        <target name="n" xsi:type="Null" layout="${message}" formatMessage="true" />
 6    </targets>
 7
 8    <rules>
 9        <logger name="*" minlevel="Debug" writeTo="n" />
10    </rules>
11</nlog>

This assumes just one target and a single rule. More configuration options are described here.

To set up the log target programmatically use code like this:

CopyC#
 1using System;
 2
 3using NLog;
 4using NLog.Targets;
 5
 6class Example
 7{
 8    static void Main(string[] args)
 9    {
10        NullTarget target = new NullTarget();
11        target.Layout = "${message}";
12        target.FormatMessage = true;
13
14        NLog.Config.SimpleConfigurator.ConfigureForTargetLogging(target, LogLevel.Debug);
15
16        Logger logger = LogManager.GetLogger("Example");
17        logger.Debug("log message");
18    }
19}

Inheritance Hierarchy

Object
  NLog.Targets..::.Target
    NLog.Targets..::.TargetWithLayout
      NLog.Targets..::.NullTarget

See Also