-
Notifications
You must be signed in to change notification settings - Fork 1.4k
AspNetRequest QueryString Layout Renderer
ASP.NET Request Query String key/value pairs.
Platforms Supported: All
Introduced in NLog.Web 4.3
${aspnet-request-querystring:items=String:outputFormat:Enum
:itemSeparator=String:valueSeparator=String
:valuesOnly=Boolean}
-
items - Query String key(s). A list of keys can be passed as comma separated values, e.g.:
Key1,Key2
(Not specified means all)Introduced with NLog.Web / NLog.Web.AspNetCore v5.2.1, and replaces the
queryStringKeys
-option.With NLog.Web / NLog.Web.AspNetCore v4.3.1 then all key/value pairs will be rendered, when not specified.
-
exclude - Query String key names to be excluded. A list of keys can be passed as comma separated values, e.g.:
Key1,Key2
Introduced with NLog.Web v5.2.2
-
outputFormat - Renders as flat string or as JSON. Default:
Flat
.-
Flat
- Key-value-pair as standard string -
JsonArray
- Key-value-pair in JSON-array (Introduced with NLog 5.0, replaces now obsoleteJson
) -
JsonDictionary
- Key-value-pair as JSON-dictionary. (Introduced with NLog 5.0, replaces now obsoletesingleAsArray
)
-
-
itemSeparator - Separator between items. Default:
,
. Only applies when OutputFormat isFlat
.Introduced in NLog.Web.AspNetCore 4.4 / NLog.Web 4.5
-
valueSeparator - Separator between value and key. Default:
=
. Only applies when OutputFormat isFlat
.Introduced in NLog.Web.AspNetCore 4.4 / NLog.Web 4.5
-
ValuesOnly - Only render the values of the key/value pairs. Default:
false
.Introduced in NLog.Web / NLog.Web.AspNetCore v4.6
-
LowerCaseKeys - Convert Keys to lowercase. Default:
false
.Introduced in NLog.Web / NLog.Web.AspNetCore v5.1.1
Use this layout renderer to insert the value of the specified query string parameters stored in the ASP.NET Query String collection.
In C# code:
Response.Redirect("myPage.aspx?key1=value1&id=d4b20a34-6231-4201-83a6-c72599e41164");
${aspnet-request-querystring:items=key1}
Will print:
"key1=value1"
${aspnet-request-querystring:items=key1,id}
Will print:
"key1=value1,id=d4b20a34-6231-4201-83a6-c72599e41164"
${aspnet-request-querystring:items=key1:OutputFormat=JSON}
Will print:
[{"key1":"value1"}]
${aspnet-request-querystring:items=key1,id:OutputFormat=JSON}
Will print:
[{"key1":"value1","id":"d4b20a34-6231-4201-83a6-c72599e41164"}]
${aspnet-request-querystring:items=key1:OutputFormat=JsonDictionary}
Will print:
{"key1":"value1"}
${aspnet-request-querystring:items=key1:ValuesOnly=true}
Will print:
"value1"
${aspnet-request-querystring:items=key1:OutputFormat=JSON:ValuesOnly=true}
Will print:
["value1"]
${aspnet-request-querystring:items=key1,id:OutputFormat=JSON:ValuesOnly=true}
Will print:
["value1","d4b20a34-6231-4201-83a6-c72599e41164"]
- Troubleshooting Guide - See available NLog Targets and Layouts: https://nlog-project.org/config
- Getting started
- How to use structured logging
- Troubleshooting
- FAQ
-
All targets, layouts and layout renderers
Popular: - Using NLog with NLog.config
- Using NLog with appsettings.json