Mail target
通过SMTP协议发送Email信息
语法
< targets > < target xsi:type = "Mail" name = "String" header = "Layout" footer = "Layout" layout = "Layout" html = "Boolean" addNewLines = "Boolean" replaceNewlineWithBrTagInHtml = "Boolean" encoding = "Encoding" subject = "Layout" to = "Layout" bcc = "Layout" cc = "Layout" from = "Layout" body = "Layout" smtpUserName = "Layout" enableSsl = "Boolean" smtpPassword = "Layout" smtpAuthentication = "Enum" smtpServer = "Layout" smtpPort = "Integer" useSystemNetMailSettings = "Boolean" timeout = "Integer" /> </ targets > |
参数
一般配置
name - target的名称
布局配置
header - 信息页头
footer - 信息页尾
layout - 输出文本格式。默认: ${longdate}|${level:uppercase=true}|${logger}|${message}
html - 是否将发送的信息转换为html格式,而不是纯文本。默认:False
addNewLines - 是否在每次输出信息之间,加一个空行
replaceNewlineWithBrTagInHtml - 是否把输出文本中的换行符替换为<br/>。默认:False
encoding - 输出日志的文本格式。默认: UTF-8
信息配置
subject - 邮件标题。默认: ${machinename}
to - 发送的邮件地址,多个用分号分隔 (e.g.john@domain.com;jane@domain.com)。
bcc - 密送的邮件地址, 多个用分号分隔(e.g.john@domain.com;jane@domain.com)。
cc - 抄送的邮件地址, 多个用分号分隔 (e.g.john@domain.com;jane@domain.com)。
from - 发送者地址 (e.g. joe@domain.com)。
body - 邮件正文(repeated for each log message send in one mail)。默认:${message}
SMTP 配置
smtpUserName - 连接SMTP服务器的用户名(当SmtpAuthentication配置为"basic"时有效)。
enableSsl - 是否启用SSL。默认False
这个参数在下面情况不被支持
- NLog v1.0 for .NET Framework 1.0
- NLog v1.0 for .NET Framework 1.1
- NLog v1.0 for .NET Framework 2.0
smtpPassword - 连接SMTP服务器的密码 (当SmtpAuthentication配置为"basic"时有效)。
smtpAuthentication - SMTP服务器验证模式
可能的值:
- Basic - 基础方式(用户名和用户密码)
- None - 不需要验证
- Ntlm - NTLM 验证
smtpServer - SMTP 服务器地址
smtpPort - SMTP服务器端口。默认: 25
useSystemNetMailSettings - 从 system.net/mailSettings获取配置。 默认: False
timeout - SMTP客户端超时时间。默认: 10000
备注
应用程序配置文件
如果应用程序的配置文件包含了邮件配置
< system.net > < mailSettings > < smtp from = "mail@domain.com" deliveryMethod = "SpecifiedPickupDirectory" > < network host = "localhost" port = "25" /> < specifiedPickupDirectory pickupDirectoryLocation = "C:/Temp/Email" /> </ smtp > </ mailSettings > </ system.net > |
如果target没有重新配置,这个值将被使用。
邮件地址格式
你能够使用下面的邮件地址格式:
"John Doe <john.doe@example.com>"
但是,如果有特殊字符 < and > ,则必须转译。John Doe会被转移为: <john.doe@example.com>