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

Outputs log messages through the OutputDebugString() Win32 API.

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

Syntax

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

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="OutputDebugString" layout="${message}" />
 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;
 5using NLog.Win32.Targets;
 6
 7class Example
 8{
 9    static void Main(string[] args)
10    {
11        OutputDebugStringTarget target = new OutputDebugStringTarget();
12        target.Layout = "${message}";
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..::.OutputDebugStringTarget

See Also