Last updated: 2006-09-18

This website is based on NLog v1.0. Click here to view the documentation for other versions.

MessageBox Target


Pops up logging messages as message boxes.

AssemblyClass.NET Framework.NET CFMono on WindowsMono on Unix
1.01.12.01.02.01.02.01.02.0
NLog.dllNLog.Targets.MessageBoxTarget

Parameters (blue fields are required):

NameTypeDescription
layoutstring  ${}
The text to be rendered.

Default value is: ${longdate}|${level:uppercase=true}|${logger}|${message}.

namestring
The name of the target.
captionstring  ${}
Message box title.

Example:

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

<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
  <targets> 
    <target name="msgbox" xsi:type="MessageBox" layout="${longdate}: ${message}" 
            caption="${level}"/> 
  </targets> 
  <rules> 
    <logger name="*" minlevel="Debug" writeTo="msgbox"/> 
  </rules> 
</nlog> 

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

The result is a message box:

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

using System; 
 
using NLog; 
using NLog.Targets; 
 
class Example 
{ 
    static void Main(string[] args) 
    { 
        MessageBoxTarget target = new MessageBoxTarget(); 
        target.Layout = "${longdate}: ${message}"; 
        target.Caption = "${level} message"; 
 
        NLog.Config.SimpleConfigurator.ConfigureForTargetLogging(target, LogLevel.Debug); 
 
        Logger logger = LogManager.GetLogger("Example"); 
        logger.Debug("log message"); 
    } 
}

Back to the target list.
Webwww.nlog-project.org