diff --git a/CMS_SC/CMS_SC.csproj b/CMS_SC/CMS_SC.csproj index 1dfc064..5141a62 100644 --- a/CMS_SC/CMS_SC.csproj +++ b/CMS_SC/CMS_SC.csproj @@ -1,5 +1,5 @@  - + Debug @@ -13,7 +13,7 @@ Properties CMS_SC CMS_SC - v4.5 + v4.5.2 true @@ -22,6 +22,7 @@ False + true @@ -106,8 +107,18 @@ True - - + + False + ExtLib\Microsoft.ReportViewer.Common.dll + + + False + ExtLib\Microsoft.ReportViewer.WebForms.dll + + + False + ExtLib\Microsoft.ReportViewer.WinForms.dll + ..\packages\Microsoft.AspNet.ScriptManager.MSAjax.5.0.0\lib\net45\Microsoft.ScriptManager.MSAjax.dll True @@ -126,7 +137,6 @@ - @@ -136,7 +146,6 @@ ..\packages\Microsoft.AspNet.Web.Optimization.1.1.3\lib\net40\System.Web.Optimization.dll True - @@ -150,6 +159,7 @@ True ..\packages\Microsoft.Web.Infrastructure.1.0.0.0\lib\net40\Microsoft.Web.Infrastructure.dll + ..\packages\WebGrease.1.6.0\lib\WebGrease.dll True @@ -257,6 +267,9 @@ + + + diff --git a/CMS_SC/ExtLib/Microsoft.ReportViewer.Common.dll b/CMS_SC/ExtLib/Microsoft.ReportViewer.Common.dll new file mode 100644 index 0000000..fe74ce4 Binary files /dev/null and b/CMS_SC/ExtLib/Microsoft.ReportViewer.Common.dll differ diff --git a/CMS_SC/ExtLib/Microsoft.ReportViewer.WebForms.dll b/CMS_SC/ExtLib/Microsoft.ReportViewer.WebForms.dll new file mode 100644 index 0000000..08d1a99 Binary files /dev/null and b/CMS_SC/ExtLib/Microsoft.ReportViewer.WebForms.dll differ diff --git a/CMS_SC/ExtLib/Microsoft.ReportViewer.WinForms.dll b/CMS_SC/ExtLib/Microsoft.ReportViewer.WinForms.dll new file mode 100644 index 0000000..684d8d2 Binary files /dev/null and b/CMS_SC/ExtLib/Microsoft.ReportViewer.WinForms.dll differ diff --git a/CMS_SC/Web.config b/CMS_SC/Web.config index ad192ae..68b0eed 100644 --- a/CMS_SC/Web.config +++ b/CMS_SC/Web.config @@ -1,4 +1,4 @@ - + -
+
-
-
-
-
+
+
+
+
-
-
+
+
- - - - - - + + + + + + - - - - - - + + + + + + - - - - - - + + + + + + - - - - - + + + + - + - - + + - - - - - - + + + + + + - - + + - - - - - - - - + + + + + + + + - + - + - - - - + + + + - - - - - + + + + + - - - - - + + + + + - + - - + + + - + - + - + - + - + - + - - - - - + + + + + - - + + - + - - + + - - + + - - + + - - + + - - + + - - + + - - - - + + + + - + - - - - - + + + + + - - + + @@ -207,12 +214,12 @@ See http://code.google.com/p/elmah/wiki/SecuringErrorLogPages for more information on remote access and securing ELMAH. --> - + - + - - @@ -39,4 +38,4 @@ --> - \ No newline at end of file + diff --git a/CMS_SC/bin/NLog.xml b/CMS_SC/bin/NLog.xml index 76e4ca8..c97ead3 100644 --- a/CMS_SC/bin/NLog.xml +++ b/CMS_SC/bin/NLog.xml @@ -521,16 +521,26 @@ NLog internal logger. + + Writes to file, console or custom textwriter (see ) + + Don't use as that can lead to recursive calls - stackoverflows + Initializes static members of the InternalLogger class. + + + Set the config of the InternalLogger with defaults and config. + + - Logs the specified message at the specified level. + Logs the specified message without an at the specified level. Log level. Message which may include positional parameters. @@ -538,103 +548,439 @@ - Logs the specified message at the specified level. + Logs the specified message without an at the specified level. Log level. Log message. + + + Logs the specified message with an at the specified level. + + Exception to be logged. + Log level. + Message which may include positional parameters. + Arguments to the message. + + + + Logs the specified message with an at the specified level. + + Exception to be logged. + Log level. + Log message. + + + + Write to internallogger. + + optional exception to be logged. + level + message + optional args for + + + + Determine if logging should be avoided because of exception type. + + The exception to check. + true if logging should be avoided; otherwise, false. + + + + Determine if logging is enabled. + + The for the log event. + true if logging is enabled; otherwise, false. + + + + Write internal messages to the . + + A message to write. + + Works when property set to true. + The is used in Debug and Relese configuration. + The works only in Debug configuration and this is reason why is replaced by . + in DEBUG + + + + + Logs the assembly version and file version of the given Assembly. + + The assembly to log. + - Logs the specified message at the Trace level. + Logs the specified message without an at the Trace level. Message which may include positional parameters. Arguments to the message. - Logs the specified message at the Trace level. + Logs the specified message without an at the Trace level. Log message. + + + Logs the specified message with an at the Trace level. + + Exception to be logged. + Message which may include positional parameters. + Arguments to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + Message which may include positional parameters. + Argument {0} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + The type of the third argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + Argument {2} to the message. + + + + Logs the specified message with an at the Trace level. + + Exception to be logged. + Log message. + - Logs the specified message at the Debug level. + Logs the specified message without an at the Debug level. Message which may include positional parameters. Arguments to the message. - Logs the specified message at the Debug level. + Logs the specified message without an at the Debug level. Log message. + + + Logs the specified message with an at the Debug level. + + Exception to be logged. + Message which may include positional parameters. + Arguments to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + Message which may include positional parameters. + Argument {0} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + The type of the third argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + Argument {2} to the message. + + + + Logs the specified message with an at the Debug level. + + Exception to be logged. + Log message. + - Logs the specified message at the Info level. + Logs the specified message without an at the Info level. Message which may include positional parameters. Arguments to the message. - Logs the specified message at the Info level. + Logs the specified message without an at the Info level. Log message. + + + Logs the specified message with an at the Info level. + + Exception to be logged. + Message which may include positional parameters. + Arguments to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + Message which may include positional parameters. + Argument {0} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + The type of the third argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + Argument {2} to the message. + + + + Logs the specified message with an at the Info level. + + Exception to be logged. + Log message. + - Logs the specified message at the Warn level. + Logs the specified message without an at the Warn level. Message which may include positional parameters. Arguments to the message. - Logs the specified message at the Warn level. + Logs the specified message without an at the Warn level. Log message. + + + Logs the specified message with an at the Warn level. + + Exception to be logged. + Message which may include positional parameters. + Arguments to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + Message which may include positional parameters. + Argument {0} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + The type of the third argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + Argument {2} to the message. + + + + Logs the specified message with an at the Warn level. + + Exception to be logged. + Log message. + - Logs the specified message at the Error level. + Logs the specified message without an at the Error level. Message which may include positional parameters. Arguments to the message. - Logs the specified message at the Error level. + Logs the specified message without an at the Error level. Log message. + + + Logs the specified message with an at the Error level. + + Exception to be logged. + Message which may include positional parameters. + Arguments to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + Message which may include positional parameters. + Argument {0} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + The type of the third argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + Argument {2} to the message. + + + + Logs the specified message with an at the Error level. + + Exception to be logged. + Log message. + - Logs the specified message at the Fatal level. + Logs the specified message without an at the Fatal level. Message which may include positional parameters. Arguments to the message. - Logs the specified message at the Fatal level. + Logs the specified message without an at the Fatal level. Log message. + + + Logs the specified message with an at the Fatal level. + + Exception to be logged. + Message which may include positional parameters. + Arguments to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + Message which may include positional parameters. + Argument {0} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + + + + Logs the specified message without an at the Trace level. + + The type of the first argument. + The type of the second argument. + The type of the third argument. + Message which may include positional parameters. + Argument {0} to the message. + Argument {1} to the message. + Argument {2} to the message. + + + + Logs the specified message with an at the Fatal level. + + Exception to be logged. + Log message. + - Gets or sets the internal log level. + Gets or sets the minimal internal log level. + If set to , then messages of the levels , and will be written. Gets or sets a value indicating whether internal messages should be written to the console output stream. + Your application must be a console application. Gets or sets a value indicating whether internal messages should be written to the console error stream. + Your application must be a console application. + + + + Gets or sets a value indicating whether internal messages should be written to the . + @@ -1250,6 +1596,52 @@ The relational operator. Result of the given relational operator. + + + Promote values to the type needed for the comparision, e.g. parse a string to int. + + + + + + + Promoto to type + + + + success? + + + + Try to promote both values. First try to promote to , + when failed, try to . + + + + + + Get the order for the type for comparision. + + + index, 0 to maxint. Lower is first + + + + Dictionary from type to index. Lower index should be tested first. + + + + + Build the dictionary needed for the order of the types. + + + + + + Get the string representing the current + + + Gets the left expression. @@ -1486,17 +1878,19 @@ Provides registration information for named items (targets, layouts, layout renderers, etc.) managed by NLog. - - - Initializes static members of the class. - - Initializes a new instance of the class. The assemblies to scan for named items. + + + gets the factory + + not using due to backwardscomp. + + Registers named items from the assembly. @@ -1537,6 +1931,10 @@ Gets or sets default singleton instance of . + + This property implements lazy instantiation so that the is not built before + the internal logger is configured. + @@ -1576,6 +1974,11 @@ The ambient property factory. + + + Gets or sets the JSON serializer to use with . + + Gets the time source factory. @@ -1598,6 +2001,46 @@ Initializes a new instance of the class. + + + Format of the excpetion output to the specific target. + + + + + Appends the Message of an Exception to the specified target. + + + + + Appends the type of an Exception to the specified target. + + + + + Appends the short type of an Exception to the specified target. + + + + + Appends the result of calling ToString() on an Exception to the specified target. + + + + + Appends the method name from Exception's stack trace to the specified target. + + + + + Appends the stack trace from an Exception to the specified target. + + + + + Appends the contents of an Exception's Data property to the specified target. + + Factory for class-based items. @@ -1703,6 +2146,31 @@ The name of the item. Created item. + + + Factory specialized for s. + + + + + Clear all func layouts + + + + + Register a layout renderer with a callback function. + + Name of the layoutrenderer, without ${}. + the renderer that renders the value. + + + + Tries to create an item instance. + + Name of the item. + The result. + True if instance was created successfully, false otherwise. + Implemented by objects which support installation and uninstallation. @@ -1817,10 +2285,11 @@ - - Keeps logging configuration and provides simple API - to modify it. - + + Keeps logging configuration and provides simple API + to modify it. + + This class is thread-safe..ToList() is used for that purpose. @@ -1832,6 +2301,12 @@ Initializes a new instance of the class. + + + Compare objects based on their name. + + This property is use to cache the comparer object. + Registers the specified target object. The name of the target is read from . @@ -1851,6 +2326,8 @@ The target object. + when is + when is @@ -1875,6 +2352,54 @@ Found target or when the target is not found of not of type + + + Add a rule with min- and maxLevel. + + Minimum log level needed to trigger this rule. + Maximum log level needed to trigger this rule. + Name of the target to be written when the rule matches. + Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. + + + + Add a rule with min- and maxLevel. + + Minimum log level needed to trigger this rule. + Maximum log level needed to trigger this rule. + Target to be written to when the rule matches. + Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. + + + + Add a rule for one loglevel. + + log level needed to trigger this rule. + Name of the target to be written when the rule matches. + Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. + + + + Add a rule for one loglevel. + + log level needed to trigger this rule. + Target to be written to when the rule matches. + Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. + + + + Add a rule for alle loglevels. + + Name of the target to be written when the rule matches. + Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. + + + + Add a rule for alle loglevels. + + Target to be written to when the rule matches. + Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. + Called by LogManager when one of the log configuration files changes. @@ -1914,6 +2439,15 @@ Closes all targets and releases any unmanaged resources. + + + Log to the internal (NLog) logger the information about the and associated with this instance. + + + The information are only recorded in the internal logger if Debug level is enabled, otherwise nothing is + recorded. + + Flushes any pending log messages on all appenders. @@ -1925,10 +2459,17 @@ Validates the configuration. + + + Copies all variables from provided dictionary into current configuration variables. + + Master variables dictionary + Use the old exception log handling of NLog 3.0? + This method was marked as obsolete on NLog 4.1 and it may be removed in a future release. @@ -1969,6 +2510,11 @@ Gets all targets. + + + Defines methods to support the comparison of objects for equality based on their name. + + Arguments for events. @@ -1998,6 +2544,12 @@ Arguments for . + + + Initializes a new instance of the class. + + Whether configuration reload has succeeded. + Initializes a new instance of the class. @@ -2027,6 +2579,15 @@ Create an empty . + + + Create a new with a and which writes to . + + Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. + Minimum log level needed to trigger this rule. + Maximum log level needed to trigger this rule. + Target to be written to when the rule matches. + Create a new with a which writes to . @@ -2037,7 +2598,7 @@ - Create a (disabled) . You should call to enable logging. + Create a (disabled) . You should call or see cref="EnableLoggingForLevels"/> to enable logging. Logger name pattern. It may include the '*' wildcard at the beginning, at the end or at both ends. Target to be written to when the rule matches. @@ -2048,6 +2609,13 @@ Level to be enabled. + + + Enables logging for a particular levels between (included) and . + + Minimum log level needed to trigger this rule. + Maximum log level needed to trigger this rule. + Disables logging for a particular level. @@ -2219,6 +2787,11 @@ Prevents a default instance of the class from being created. + + + Last error occured during configuration read + + Returns children elements with the specified element name. @@ -2242,6 +2815,14 @@ Default value to return if the attribute is not found. Boolean attribute value or default. + + + Gets the optional boolean attribute value. If whitespace, then returning null. + + Name of the attribute. + Default value to return if the attribute is not found. + Boolean attribute value or default. + Gets the optional attribute value. @@ -2256,6 +2837,11 @@ The allowed names. + + + Returns all parsing errors from current and all child elements. + + Gets the element name. @@ -2285,6 +2871,8 @@ Provides simple programmatic configuration API used for trivial logging cases. + + Warning, these methods will overwrite the current config. @@ -2360,12 +2948,24 @@ Marks the layout or layout renderer as producing correct results regardless of the thread it's running on. + + This is important because some layout renders should use the main thread. E.g. for using HttpContext.Current etc. + + If set to true then a layout will be render in the main thread, so for example in the AsyncTargetWrapper and BufferTargetWrapper with the , using + + Apply this attribute when: + - The result can we rendered in another thread. Delaying this could be more efficient. And/Or, + - The result should not be precalculated, for example the target sends some extra context information. + - - A class for configuring NLog through an XML configuration file - (App.config style or App.nlog style). - + + A class for configuring NLog through an XML configuration file + (App.config style or App.nlog style). + + Parsing of the XML file is also implemented in this class. + + This class is thread-safe..ToList() is used for that purpose. @@ -2373,6 +2973,13 @@ Configuration file to be read. + + + Initializes a new instance of the class. + + Configuration file to be read. + The to which to apply any applicable configuration values. + Initializes a new instance of the class. @@ -2380,6 +2987,21 @@ Configuration file to be read. Ignore any errors during configuration. + + + Initializes a new instance of the class. + + Configuration file to be read. + Ignore any errors during configuration. + The to which to apply any applicable configuration values. + + + + Create XML reader for (xml config) file. + + filepath + reader or null if filename is empty. + Initializes a new instance of the class. @@ -2387,6 +3009,14 @@ containing the configuration section. Name of the file that contains the element (to be used as a base for including other files). + + + Initializes a new instance of the class. + + containing the configuration section. + Name of the file that contains the element (to be used as a base for including other files). + The to which to apply any applicable configuration values. + Initializes a new instance of the class. @@ -2395,6 +3025,15 @@ Name of the file that contains the element (to be used as a base for including other files). Ignore any errors during configuration. + + + Initializes a new instance of the class. + + containing the configuration section. + Name of the file that contains the element (to be used as a base for including other files). + Ignore any errors during configuration. + The to which to apply any applicable configuration values. + Initializes a new instance of the class. @@ -2416,6 +3055,23 @@ The new object. + + + Get file paths (including filename) for the possible NLog config files. + + The filepaths to the possible config file + + + + Overwrite the paths (including filename) for the possible NLog config files. + + The filepaths to the possible config file + + + + Clear the candidate file paths and return to the defaults. + + Remove all spaces, also in between text. @@ -2442,26 +3098,44 @@ Name of the file that contains the element (to be used as a base for including other files). Ignore any errors during configuration. - + + + Checks whether any error during XML configuration parsing has occured. + If there are any and ThrowConfigExceptions or ThrowExceptions + setting is enabled - throws NLogConfigurationException, otherwise + just write an internal log at Warn level. + + Root NLog configuration xml element + + + + Checks whether unused targets exist. If found any, just write an internal log at Warn level. + If initializing not started or failed, then checking process will be canceled + + + Parse the root - path to directory of config file. + path to config file. + The default value for the autoReload option. - + Parse {configuration} xml element. - path to directory of config file. + path to config file. + The default value for the autoReload option. - + Parse {NLog} xml element. - path to directory of config file. + path to config file. + The default value for the autoReload option. @@ -2499,7 +3173,7 @@ - Gets or sets a value indicating whether the configuration files + Gets or sets a value indicating whether all of the configuration files should be watched for changes and reloaded automatically when changed. @@ -2828,28 +3502,28 @@ Sets the information of the logging event. The exception information of the logging event. - + current for chaining calls. Sets the level of the logging event. The level of the logging event. - + current for chaining calls. Sets the logger name of the logging event. The logger name of the logging event. - + current for chaining calls. Sets the log message on the logging event. The log message for the logging event. - + current for chaining calls. @@ -2857,7 +3531,7 @@ A composite format string. The object to format. - + current for chaining calls. @@ -2866,7 +3540,7 @@ A composite format string. The first object to format. The second object to format. - + current for chaining calls. @@ -2876,7 +3550,7 @@ The first object to format. The second object to format. The third object to format. - + current for chaining calls. @@ -2887,7 +3561,7 @@ The second object to format. The third object to format. The fourth object to format. - + current for chaining calls. @@ -2895,7 +3569,7 @@ A composite format string. An object array that contains zero or more objects to format. - + current for chaining calls. @@ -2904,7 +3578,7 @@ An object that supplies culture-specific formatting information. A composite format string. An object array that contains zero or more objects to format. - + current for chaining calls. @@ -2912,21 +3586,21 @@ The name of the context property. The value of the context property. - + current for chaining calls. Sets multiple per-event context properties on the logging event. The properties to set. - + current for chaining calls. Sets the timestamp of the logging event. The timestamp of the logging event. - + current for chaining calls. @@ -2934,7 +3608,7 @@ The stack trace. Index of the first user stack frame within the stack trace. - + current for chaining calls. @@ -2978,54 +3652,55 @@ The logger to write the log event to. The log level. - + current for chaining calls. Starts building a log event at the Trace level. The logger to write the log event to. - + current for chaining calls. Starts building a log event at the Debug level. The logger to write the log event to. - + current for chaining calls. Starts building a log event at the Info level. The logger to write the log event to. - + current for chaining calls. Starts building a log event at the Warn level. The logger to write the log event to. - + current for chaining calls. Starts building a log event at the Error level. The logger to write the log event to. - + current for chaining calls. Starts building a log event at the Fatal level. The logger to write the log event to. - + current for chaining calls. Global Diagnostics Context - used for log4net compatibility. + This class was marked as obsolete on NLog 2.0 and it may be removed in a future release. @@ -3040,6 +3715,7 @@ Item name. The value of , if defined; otherwise . + If the value isn't a already, this call locks the for reading the needed for converting to . @@ -3048,6 +3724,7 @@ Item name. to use when converting the item's value to a string. The value of as a string, if defined; otherwise . + If is null and the value isn't a already, this call locks the for reading the needed for converting to . @@ -3099,6 +3776,7 @@ Item name. The value of , if defined; otherwise . + If the value isn't a already, this call locks the for reading the needed for converting to . @@ -3107,6 +3785,7 @@ Item name. to use when converting the item's value to a string. The value of as a string, if defined; otherwise . + If is null and the value isn't a already, this call locks the for reading the needed for converting to . @@ -3115,6 +3794,12 @@ Item name. The item value, if defined; otherwise null. + + + Returns all item names + + A collection of the names of all items in the Global Diagnostics Context. + Checks whether the specified item exists in the Global Diagnostics Context. @@ -3142,6 +3827,9 @@ + + Logger with only generic methods (passing 'LogLevel' to methods) and core properties. + Auto-generated Logger members for binary compatibility with NLog 1.0. @@ -3200,6 +3888,7 @@ The log level. A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -3251,6 +3940,7 @@ The log level. A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -3598,64 +4288,68 @@ - Runs action. If the action throws, the exception is logged at Error level. Exception is not propagated outside of this method. + Runs the provided action. If the action throws, the exception is logged at Error level. The exception is not propagated outside of this method. Action to execute. - Runs the provided function and returns its result. If exception is thrown, it is logged at Error level. - Exception is not propagated outside of this method. Fallback value is returned instead. + Runs the provided function and returns its result. If an exception is thrown, it is logged at Error level. + The exception is not propagated outside of this method; a default value is returned instead. Return type of the provided function. Function to run. - Result returned by the provided function or fallback value in case of exception. + Result returned by the provided function or the default value of type in case of exception. - Runs the provided function and returns its result. If exception is thrown, it is logged at Error level. - Exception is not propagated outside of this method. Fallback value is returned instead. + Runs the provided function and returns its result. If an exception is thrown, it is logged at Error level. + The exception is not propagated outside of this method; a fallback value is returned instead. Return type of the provided function. Function to run. - Fallback value to return in case of exception. Defaults to default value of type T. + Fallback value to return in case of exception. Result returned by the provided function or fallback value in case of exception. + + + Logs an exception is logged at Error level if the provided task does not run to completion. + + The task for which to log an error if it does not run to completion. + This method is useful in fire-and-forget situations, where application logic does not depend on completion of task. This method is avoids C# warning CS4014 in such situations. + - If the task causes an exception or is canceled, the exception is logged at Error level. Exception is not propagated outside of this method. + Returns a task that completes when a specified task to completes. If the task does not run to completion, an exception is logged at Error level. The returned task always runs to completion. - Task for which to log an exception or cancellation. - A task that completes when after completes. - - This task returned by this method does not include a return value, even if is of type because the value is not present if the task causes an exception or is canceled. - If your code requires the return value, do not use this method to swallow the exception; instead, await the task normally and catch the exception to handle the case of no return value. - + The task for which to log an error if it does not run to completion. + A task that completes in the state when completes. - Runs async action. If the action throws, the exception is logged at Error level. Exception is not propagated outside of this method. + Runs async action. If the action throws, the exception is logged at Error level. The exception is not propagated outside of this method. Async action to execute. + A task that completes in the state when completes. - Runs the provided async function and returns its result. If exception is thrown, it is logged at Error level. - Exception is not propagated outside of this method. Fallback value is returned instead. + Runs the provided async function and returns its result. If the task does not run to completion, an exception is logged at Error level. + The exception is not propagated outside of this method; a default value is returned instead. - Return type of the provided function. + Return type of the provided function. Async function to run. - Result returned by the provided function or fallback value in case of exception. + A task that represents the completion of the supplied task. If the supplied task ends in the state, the result of the new task will be the result of the supplied task; otherwise, the result of the new task will be the default value of type . - Runs the provided async function and returns its result. If exception is thrown, it is logged at Error level. - Exception is not propagated outside of this method. Fallback value is returned instead. + Runs the provided async function and returns its result. If the task does not run to completion, an exception is logged at Error level. + The exception is not propagated outside of this method; a fallback value is returned instead. - Return type of the provided function. + Return type of the provided function. Async function to run. - Fallback value to return in case of exception. Defaults to default value of type T. - Result returned by the provided function or fallback value in case of exception. + Fallback value to return if the task does not end in the state. + A task that represents the completion of the supplied task. If the supplied task ends in the state, the result of the new task will be the result of the supplied task; otherwise, the result of the new task will be the fallback value. @@ -3687,6 +4381,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Trace level. + + A to be written. + An exception to be logged. @@ -3732,6 +4434,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -3826,6 +4529,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Debug level. + + A to be written. + An exception to be logged. @@ -3871,6 +4582,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -3965,6 +4677,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Info level. + + A to be written. + An exception to be logged. @@ -4010,6 +4730,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -4104,6 +4825,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Warn level. + + A to be written. + An exception to be logged. @@ -4149,6 +4878,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -4243,6 +4973,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Error level. + + A to be written. + An exception to be logged. @@ -4288,6 +5026,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -4382,6 +5121,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Fatal level. + + A to be written. + An exception to be logged. @@ -4427,6 +5174,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -5877,11 +6625,6 @@ A value of if logging is enabled for the Fatal level, otherwise it returns . - - - Various helper methods for accessing state of ASP application. - - Internal configuration manager used to read .NET configuration files. @@ -6128,13 +6871,6 @@ Don't uses reflection - - - IsNullOrWhiteSpace for .net 3.5 - - - - Safe way to get environment variables. @@ -6145,12 +6881,37 @@ Helper class for dealing with exceptions. + + + Mark this exception as logged to the . + + + + + + + Is this exception logged to the ? + + + trueif the has been logged to the . + - Determines whether the exception must be rethrown. + Determines whether the exception must be rethrown and logs the error to the if is false. + + Advised to log first the error to the before calling this method. - The exception. - True if the exception must be rethrown, false otherwise. + The exception to check. + trueif the must be rethrown, false otherwise. + + + + Determines whether the exception must be rethrown immediately, without logging the error to the . + + Only used this method in special cases. + + The exception to check. + trueif the must be rethrown, false otherwise. @@ -6276,13 +7037,25 @@ Closes this instance. - + - Gets the file info. + Gets the creation time for a file associated with the appender. The time returned is in Coordinated Universal + Time [UTC] standard. - The last file write time. The value must be of UTC kind. - Length of the file. - True if the operation succeeded, false otherwise. + The file creation time. + + + + Gets the last time the file associated with the appeander is written. The time returned is in Coordinated + Universal Time [UTC] standard. + + The time the file was last written to. + + + + Gets the length in bytes of the file associated with the appeander. + + A long value representing the length of the file in bytes. @@ -6297,14 +7070,14 @@ - Records the last write time for a file. + Updates the last write time of the file. - Records the last write time for a file to be specific date. + Updates the last write time of the file to the specified date. - Date and time when the last write occurred. The value must be of UTC kind. + Date and time when the last write occurred in UTC. @@ -6315,21 +7088,30 @@ - Gets the name of the file. + Gets the path of the file, including file extension. The name of the file. - + - Gets the last write time. + Gets or sets the creation time for a file associated with the appender. The time returned is in Coordinated + Universal Time [UTC] standard. - The last write time. DateTime value must be of UTC kind. + The creation time of the file. - Gets the open time of the file. + Gets the last time the file associated with the appeander is opened. The time returned is in Coordinated + Universal Time [UTC] standard. - The open time. DateTime value must be of UTC kind. + The time the file was last opened. + + + + Gets the last time the file associated with the appeander is written. The time returned is in + Coordinated Universal Time [UTC] standard. + + The time the file was last written to. @@ -6337,6 +7119,46 @@ The file creation parameters. + + + Base class for optimized file appenders which require the usage of a mutex. + + It is possible to use this class as replacement of BaseFileAppender and the mutex functionality + is not enforced to the implementing subclasses. + + + + + Initializes a new instance of the class. + + Name of the file. + The create parameters. + + + + Creates a mutually-exclusive lock for archiving files. + + A object which can be used for controlling the archiving of files. + + + + Creates a mutex for archiving that is sharable by more than one process. + + A object which can be used for controlling the archiving of files. + + + + Creates a mutex that is sharable by more than one process. + + The prefix to use for the name of the mutex. + A object which is sharable by multiple processes. + + + + Gets the mutually-exclusive lock for archiving files. + + The mutex for archiving. + Implementation of which caches @@ -6360,13 +7182,25 @@ Flushes this current appender. - + - Gets the file info. + Gets the creation time for a file associated with the appender. The time returned is in Coordinated Universal + Time [UTC] standard. - The last file write time. The value must be of UTC kind. - Length of the file. - True if the operation succeeded, false otherwise. + The file creation time. + + + + Gets the last time the file associated with the appeander is written. The time returned is in Coordinated + Universal Time [UTC] standard. + + The time the file was last written to. + + + + Gets the length in bytes of the file associated with the appeander. + + A long value representing the length of the file in bytes. @@ -6402,6 +7236,92 @@ Instance of which can be used to write to the file. + + + Maintains a collection of file appenders usually associated with file targets. + + + + + An "empty" instance of the class with zero size and empty list of appenders. + + + + + Initializes a new "empty" instance of the class with zero size and empty + list of appenders. + + + + + Initializes a new instance of the class. + + + The size of the list should be positive. No validations are performed during initialisation as it is an + intenal class. + + Total number of appenders allowed in list. + Factory used to create each appender. + Parameters used for creating a file. + + + + Invalidates appenders for all files that were archived. + + + + + It allocates the first slot in the list when the file name does not already in the list and clean up any + unused slots. + + File name associated with a single appender. + The allocated appender. + + Thrown when is called on an Empty instance. + + + + + Close all the allocated appenders. + + + + + Close the allocated appenders initialised before the supplied time. + + The time which prior the appenders considered expired + + + + Fluch all the allocated appenders. + + + + + Closes the specified appender and removes it from the list. + + File name of the appender to be closed. + + + + The archive file path pattern that is used to detect when archiving occurs. + + + + + Gets the parameters which will be used for creating a file. + + + + + Gets the file appender factory used by all the appenders in this list. + + + + + Gets the number of appenders which the list can hold. + + Interface that provides parameters for create file function. @@ -6448,7 +7368,7 @@ - Gets or set a value indicating whether a managed file stream is forced, instead of used the native implementation. + Gets or set a value indicating whether a managed file stream is forced, instead of using the native implementation. @@ -6456,6 +7376,11 @@ Gets or sets the file attributes (Windows only). + + + Should we capture the last write time of a file? + + Provides a multiprocess-safe atomic file appends while @@ -6492,15 +7417,31 @@ Flushes this instance. - + - Gets the file info. + Gets the creation time for a file associated with the appender. The time returned is in Coordinated Universal + Time [UTC] standard. - The last file write time. The value must be of UTC kind. - Length of the file. - - True if the operation succeeded, false otherwise. - + The file creation time. + + + + Gets the last time the file associated with the appeander is written. The time returned is in Coordinated + Universal Time [UTC] standard. + + The time the file was last written to. + + + + Gets the length in bytes of the file associated with the appeander. + + A long value representing the length of the file in bytes. + + + + Creates a mutually-exclusive lock for archiving files. + + A object which can be used for controlling the archiving of files. @@ -6546,15 +7487,31 @@ Closes this instance. - + - Gets the file info. + Gets the creation time for a file associated with the appender. The time returned is in Coordinated Universal + Time [UTC] standard. - The last file write time. The value must be of UTC kind. - Length of the file. - - True if the operation succeeded, false otherwise. - + The file creation time. + + + + Gets the last time the file associated with the appeander is written. The time returned is in Coordinated + Universal Time [UTC] standard. + + The time the file was last written to. + + + + Gets the length in bytes of the file associated with the appeander. + + A long value representing the length of the file in bytes. + + + + Creates a mutually-exclusive lock for archiving files. + + A object which can be used for controlling the archiving of files. @@ -6599,15 +7556,25 @@ Closes this instance. - + - Gets the file info. + Gets the creation time for a file associated with the appender. The time returned is in Coordinated Universal + Time [UTC] standard. - The last file write time. The value must be of UTC kind. - Length of the file. - - True if the operation succeeded, false otherwise. - + The file creation time. + + + + Gets the last time the file associated with the appeander is written. The time returned is in Coordinated + Universal Time [UTC] standard. + + The time the file was last written to. + + + + Gets the length in bytes of the file associated with the appeander. + + A long value representing the length of the file in bytes. @@ -6624,34 +7591,114 @@ Instance of which can be used to write to the file. - + - Optimized routines to get the size and last write time of the specified file. + Provides a multiprocess-safe atomic file append while + keeping the files open. - + - Initializes static members of the FileInfoHelper class. + Initializes a new instance of the class. + + Name of the file. + The parameters. + + + + Creates or opens a file in a special mode, so that writes are automatically + as atomic writes at the file end. + See also "UnixMultiProcessFileAppender" which does a similar job on *nix platforms. + + File to create or open + + + + Writes the specified bytes. + + The bytes to be written. + + + + Closes this instance. - + + + Flushes this instance. + + + + + Gets the length in bytes of the file associated with the appeander. + + A long value representing the length of the file in bytes. + + + + Factory class. + + + + + Opens the appender for given file name and parameters. + + Name of the file. + Creation parameters. + + Instance of which can be used to write to the file. + + + + + An immutable object that stores basic file info. + + + + + Constructs a FileCharacteristics object. + + The time the file was created in UTC. + The time the file was last written to in UTC. + The size of the file in bytes. + + + + The time the file was created in UTC. + + + + + The time the file was last written to in UTC. + + + + + The size of the file in bytes. + + + + + Optimized routines to get the basic file characteristics of the specified file. + + + + + Initializes static members of the FileCharacteristicsHelper class. + + + Gets the information about a file. Name of the file. - The file handle. - The last write time of the file in UTC. - Length of the file. - A value of true if file information was retrieved successfully, false otherwise. + The file stream. + The file characteristics, if the file information was retrieved successfully, otherwise null. - + - toString(format) if the object is a + A layout that represents a filePath. - value to be converted - format value - provider, for example culture - @@ -6665,11 +7712,129 @@ The log event. String representation of a layout. + + + Cached directory separator char array to avoid memory allocation on each method call. + + + + + Cached invalid filenames char array to avoid memory allocation everytime Path.GetInvalidFileNameChars() is called. + + + + + not null when == false + + + + + non null is fixed, + + + + + is the cache-key, and when newly rendered filename matches the cache-key, + then it reuses the cleaned cache-value . + + + + + is the cache-value that is reused, when the newly rendered filename + matches the cache-key + + + + Initializes a new instance of the class. + + + + Render the raw filename from Layout + + The log event. + String representation of a layout. + + + + Convert the raw filename to a correct filename + + The filename generated by Layout. + String representation of a correct filename. + + + + Is this (templated/invalid) path an absolute, relative or unknown? + + + + + Is this (templated/invalid) path an absolute, relative or unknown? + + + + + toString(format) if the object is a + + value to be converted + format value + provider, for example culture + + + + + Convert object to string + + value + format for conversion. + + + If is null and isn't a already, then the will get a locked by + + Supports mocking of SMTP Client code. + + + Sends an e-mail message to an SMTP server for delivery. These methods block while the message is being transmitted. + + + System.Net.Mail.MailMessage + MailMessage + A MailMessage that contains the message to send. + + + + Specifies how outgoing email messages will be handled. + + + + + Gets or sets the name or IP address of the host used for SMTP transactions. + + + + + Gets or sets the port used for SMTP transactions. + + + + + Gets or sets a value that specifies the amount of time after which a synchronous Send call times out. + + + + + Gets or sets the credentials used to authenticate the sender. + + + + + Gets or sets the folder where applications save mail messages to be processed by the local SMTP server. + + Supports object initialization and termination. @@ -6729,6 +7894,7 @@ Use the old exception log handling of NLog 3.0? + This method was marked as obsolete before NLog 4.3.11 and it will be removed in NLog 5. @@ -6743,16 +7909,27 @@ - Stops the watching. + Stops watching all files. + + + Stops watching the specified file. + + + Watches the specified files for changes. The file names. - + + + The types of changes to watch for. + + + Occurs when a change is detected in one of the monitored files. @@ -6761,6 +7938,10 @@ Supports mocking of SMTP Client code. + + Disabled Error CS0618 'SmtpClient' is obsolete: 'SmtpClient and its network of types are poorly designed, + we strongly recommend you use https://github.com/jstedfast/MailKit and https://github.com/jstedfast/MimeKit instead' + @@ -6779,11 +7960,6 @@ The network URL. - - - Finalizes an instance of the NetworkSender class. - - Initializes this network sender. @@ -7084,17 +8260,17 @@ The root objects. Ordered list of objects implementing T. - - - Parameter validation utilities. - + + ISet is not there in .net35, so using HashSet - + - Asserts that the value is not null and throws otherwise. + Combine paths - The value to check. - Name of the parameter. + basepath, not null + optional dir + optional file + @@ -7121,22 +8297,28 @@ Gets a value indicating whether current OS is Unix-based. - + - Portable implementation of . + Gets a value indicating whether current runtime is Mono-based - + + + Gets a value indicating whether current runtime supports use of mutex + + + + + Portable implementation of . + + + Gets the information about a file. Name of the file. - The file handle. - The last write time of the file in UTC. - Length of the file. - - A value of true if file information was retrieved successfully, false otherwise. - + The file stream. + The file characteristics, if the file information was retrieved successfully, otherwise null. @@ -7160,11 +8342,6 @@ The instance. - - - Gets current thread ID. - - Gets current process ID. @@ -7190,12 +8367,6 @@ Gets the name of the process. - - - Gets current thread ID. - - - Gets current process ID. @@ -7219,6 +8390,44 @@ Reflection helpers for accessing properties. + + + Set value parsed from string. + + object instance to set with property + name of the property on + The value to be parsed. + + + + + Is the property of array-type? + + Type which has the property + name of the property. + + + + + Get propertyinfo + + object which could have property + propertyname on + result when success. + success. + + + + Try parse of string to (Generic) list, comma separated. + + + If there is a comma in the value, then (single) quote the value. For single quotes, use the backslash as escape + + + + + + Reflection helpers. @@ -7232,6 +8441,31 @@ Usable types from the given assembly. Types which cannot be loaded are skipped. + + + Is this a static class? + + + + This is a work around, as Type doesn't have this property. + From: http://stackoverflow.com/questions/1175888/determine-if-a-type-is-static + + + + + Creates an optimized delegate for calling the MethodInfo using Expression-Trees + + Method to optimize + Optimized delegate for invoking the MethodInfo + + + + Optimized delegate for calling MethodInfo + + Object instance, use null for static methods. + Complete list of parameters that matches the method, including optional/default parameters. + + Supported operating systems. @@ -7282,6 +8516,36 @@ The text to be tokenized. + + + Check current char while not changing the position. + + + + + + Read the current char and change position + + + + + + Get the substring of the + + + + + + + + Current position in + + + + + Full text to be parsed + + Implements a single-call guard around given continuation function. @@ -7316,6 +8580,18 @@ Dictionary where keys are unique input keys, and values are lists of . + + + Performs bucket sort (group by) on an array of items and returns a dictionary for easy traversal of the result set. + + The type of the value. + The type of the key. + The inputs. + The key selector function. + + Dictionary where keys are unique input keys, and values are lists of . + + Key selector delegate. @@ -7325,16 +8601,106 @@ Value to extract key information from. Key selected from log event. + + + Single-Bucket optimized readonly dictionary. Uses normal internally Dictionary if multiple buckets are needed. + + Avoids allocating a new dictionary, when all items are using the same bucket + + The type of the key. + The type of the value. + + + + + + + + + + + + Will always throw, as dictionary is readonly + + + Will always throw, as dictionary is readonly + + + + + + Will always throw, as dictionary is readonly + + + Will always throw, as dictionary is readonly + + + + + + + + + Will always throw, as dictionary is readonly + + + + + + + + + + + + + + + + Allows direct lookup of existing keys. If trying to access non-existing key exeption is thrown. + Consider to use instead for better safety. + + Key value for lookup + Mapped value found + + + + Non-Allocating struct-enumerator + + Utilities for dealing with values. + + + Get this stacktrace for inline unit test + + + + Stream helpers + + + Copy to output stream and skip BOM if encoding is UTF8 + + + + + + + + Copy stream input to output. Skip the first bytes + + stream to read from + stream to write to + .net35 doesn't have a .copyto + Copy stream input to output. Skip the first bytes @@ -7343,12 +8709,100 @@ stream to write to first bytes to skip (optional) + + + Helpers for , which is used in e.g. layout renderers. + + + + + Append a value and use formatProvider of or to convert to string. + + + value to append. + current logEvent for FormatProvider. + Configuration for DefaultCultureInfo + + + + Appends int without using culture, and most importantly without garbage + + + value to append + + + + Appends uint without using culture, and most importantly without garbage + + Credits Gavin Pugh - http://www.gavpugh.com/2010/04/01/xnac-avoiding-garbage-when-working-with-stringbuilder/ + + + value to append + + + + Clears the provider StringBuilder + + + + + + Helpers for . + + + + + IsNullOrWhiteSpace, including for .NET 3.5 + + + + + + + Split a string + + + + + Split string with escape. The escape char is the same as the splitchar + + + split char. escaped also with this char + + + + + Split string with escape + + + + + + + + + Split a string, optional quoted value + + Text to split + Character to split the + Quote character + + Escape for the , not escape for the + , use quotes for that. + + + Represents target with a chain of filters which determine whether logging should happen. + + + cached result as calculating is expensive. + + Initializes a new instance of the class. @@ -7379,6 +8833,7 @@ Gets or sets the next item in the chain. The next item in the chain. + This is for example the 'target2' logger in writeTo='target1,target2' @@ -7429,22 +8884,41 @@ URL Encoding helper. - + - Win32-optimized implementation of . + Escape unicode string data for use in http-requests + + unicode string-data to be encoded + target for the encoded result + s for how to perform the encoding + + + Allow UnreservedMarks instead of ReservedMarks, as specified by chosen RFC + + + Use RFC2396 standard (instead of RFC3986) + + + Should use lowercase when doing HEX escaping of special characters + + + Replace space ' ' with '+' instead of '%20' + + + Skip UTF8 encoding, and prefix special characters with '%u' + + + + Win32-optimized implementation of . - + Gets the information about a file. Name of the file. - The file handle. - The last write time of the file in UTC. - Length of the file. - - A value of true if file information was retrieved successfully, false otherwise. - + The file stream. + The file characteristics, if the file information was retrieved successfully, otherwise null. @@ -7456,12 +8930,6 @@ Initializes a new instance of the class. - - - Gets current thread ID. - - - Gets current process ID. @@ -7490,6 +8958,13 @@ removes any unusual unicode characters that can't be encoded into XML + + + Cleans string of any invalid XML chars found + + unclean string + string with only valid XML chars + Safe version of WriteAttributeString @@ -7600,6 +9075,55 @@ True to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Get the for rendering the messages to a + + LogEvent with culture + Culture in on Layout level + + + + + Get the for rendering the messages to a , needed for date and number formats + + LogEvent with culture + Culture in on Layout level + + + is preferred + + + + + Register a custom layout renderer. + + Short-cut for registing to default + Type of the layout renderer. + Name of the layout renderer - without ${}. + + + + Register a custom layout renderer. + + Short-cut for registing to default + Type of the layout renderer. + Name of the layout renderer - without ${}. + + + + Register a custom layout renderer with a callback function . The callback recieves the logEvent. + + Name of the layout renderer - without ${}. + Callback that returns the value for the layout renderer. + + + + Register a custom layout renderer with a callback function . The callback recieves the logEvent and the current configuration. + + Name of the layout renderer - without ${}. + Callback that returns the value for the layout renderer. + Gets the logging configuration this target is part of. @@ -7624,10 +9148,10 @@ - - Also render the call attributes? (, - , ). - + + Also render the call attributes? (, + , ). + @@ -7654,6 +9178,10 @@ Designates a property of the class as an ambient property. + + non-ambient: ${uppercase:${level}} + ambient : ${level:uppercase} + @@ -7697,88 +9225,11 @@ This string is used in - - - ASP Application variable. - - - - - Renders the specified ASP Application variable and appends it to the specified . - - The to append the rendered data to. - Logging event. - - - - Gets or sets the ASP Application variable name. - - - - - - ASP Request variable. - - - - - Renders the specified ASP Request variable and appends it to the specified . - - The to append the rendered data to. - Logging event. - - - - Gets or sets the item name. The QueryString, Form, Cookies, or ServerVariables collection variables having the specified name are rendered. - - - - - - Gets or sets the QueryString variable to be rendered. - - - - - - Gets or sets the form variable to be rendered. - - - - - - Gets or sets the cookie to be rendered. - - - - - - Gets or sets the ServerVariables item to be rendered. - - - - - - ASP Session variable. - - - - - Renders the specified ASP Session variable and appends it to the specified . - - The to append the rendered data to. - Logging event. - - - - Gets or sets the session variable name. - - - Assembly version. + The entry assembly can't be found in some cases e.g. ASP.NET, Unit tests etc. @@ -7787,6 +9238,11 @@ The to append the rendered data to. Logging event. + + + The (full) name of the assembly. If null, using the entry assembly. + + The current application domain's base directory. @@ -7844,6 +9300,12 @@ + + + Gets or sets a value indicating whether to render the include the namespace with . + + + Gets or sets a value indicating whether to render the method name. @@ -7945,6 +9407,12 @@ Initializes a new instance of the class. + + Cache-key (Last DateTime.UtcNow) + Cache-Value (DateTime.Format result) + + + Cache-key (Last DateTime.Now) + Cache-Value (DateTime.Format result) + Renders the current date and appends it to the specified . @@ -7998,6 +9466,7 @@ Log event context data. + This class was marked as obsolete on NLog 2.0 and it may be removed in a future release. @@ -8069,35 +9538,35 @@ Appends the Message of an Exception to the specified . The to append the rendered data to. - The exception containing the Message to append. + The exception containing the Message to append. Appends the method name from Exception's stack trace to the specified . The to append the rendered data to. - The Exception whose method name should be appended. + The Exception whose method name should be appended. Appends the stack trace from an Exception to the specified . The to append the rendered data to. - The Exception whose stack trace should be appended. + The Exception whose stack trace should be appended. Appends the result of calling ToString() on an Exception to the specified . The to append the rendered data to. - The Exception whose call to ToString() should be appended. + The Exception whose call to ToString() should be appended. Appends the type of an Exception to the specified . The to append the rendered data to. - The Exception whose type should be appended. + The Exception whose type should be appended. @@ -8113,13 +9582,22 @@ The to append the rendered data to. The Exception whose Data property elements should be appended. + + + Split the string and then compile into list of Rendering formats. + + + + Gets or sets the format of the output. Must be a comma-separated list of exception properties: Message, Type, ShortType, ToString, Method, StackTrace. This parameter value is case-insensitive. - + + + @@ -8135,6 +9613,12 @@ + + + Gets or sets the separator used to concatenate exception data specified in the Format. + + + Gets or sets the maximum number of inner exceptions to include in the output. @@ -8148,6 +9632,20 @@ + + + Gets the formats of the output of inner exceptions to be rendered in target. + + + + + + + Gets the formats of the output to be rendered in target. + + + + Renders contents of the specified file. @@ -8178,6 +9676,35 @@ The encoding. + + + A layout renderer which could have different behavior per instance by using a . + + + + + Create a new. + + Name without ${}. + Method that renders the layout. + + + + Renders the specified environmental information and appends it to the specified . + + The to append the rendered data to. + Logging event. + + + + Name used in config without ${}. E.g. "test" could be used as "${test}". + + + + + Method that renders the layout. + + The information about the garbage collector. @@ -8339,14 +9866,15 @@ - Marks class as a layout renderer and assigns a format string to it. + Marks class as a layout renderer and assigns a name to it. + This attribute is not required when registering the layout in the API. Initializes a new instance of the class. - Name of the layout renderer. + Name of the layout renderer, without the `${ }` @@ -8754,6 +10282,12 @@ + + + Gets or sets the format-string to use if the property supports it (Ex. DateTime / TimeSpan / Enum) + + + Property of System.Diagnostics.Process to retrieve. @@ -8984,6 +10518,14 @@ The to append the rendered data to. Logging event. + + + Write timestamp to builder with format hh:mm:ss:fff + + + + + High precision timer, based on the value returned from QueryPerformanceCounter() optionally converted to seconds. @@ -9044,6 +10586,11 @@ A value from the Registry. + + + Create new renderer + + Reads the specified registry key and value and appends it to @@ -9052,6 +10599,18 @@ The to append the rendered data to. Logging event. Ignored. + + + Parse key to and subkey. + + full registry key name + Result of parsing, never null. + + + + Aliases for the hives. See https://msdn.microsoft.com/en-us/library/ctb3kd86(v=vs.110).aspx + + Gets or sets the registry value name. @@ -9064,20 +10623,50 @@ - + - Gets or sets the registry key. + Require escaping backward slashes in . Need to be backwardscompatible. + + When true: + + `\` in value should be configured as `\\` + `\\` in value should be configured as `\\\\`. + + Default value wasn't a Layout before and needed an escape of the slash + + + + Gets or sets the registry view (see: https://msdn.microsoft.com/de-de/library/microsoft.win32.registryview.aspx). + Allowed values: Registry32, Registry64, Default + + + + + Gets or sets the registry key. + + + HKCU\Software\NLogTest + + + Possible keys: +
    +
  • HKEY_LOCAL_MACHINE
    • +
  • HKLM
    • +
  • HKEY_CURRENT_USER
    • +
  • HKCU
    • +
  • HKEY_CLASSES_ROOT
    • +
  • HKEY_USERS
    • +
  • HKEY_CURRENT_CONFIG
    • +
  • HKEY_DYN_DATA
    • +
  • HKEY_PERFORMANCE_DATA
    • +
+ + + + + + Has ? - - Must have one of the forms: -
    -
  • HKLM\Key\Full\Name
    • -
  • HKEY_LOCAL_MACHINE\Key\Full\Name
    • -
  • HKCU\Key\Full\Name
    • -
  • HKEY_CURRENT_USER\Key\Full\Name
    • -
- - @@ -9097,6 +10686,17 @@ + + + Appends a date in format yyyy-MM-dd to the StringBuilder. + The DateTime.ToString() result is cached for future uses + since it only changes once a day. This optimization yields a + performance boost of 40% and makes the renderer allocation-free + in must cases. + + The to append the date to + The date to append + System special folder path (includes My Documents, My Music, Program Files, Desktop, and more). @@ -9302,6 +10902,18 @@ Render a NLog variable (xml or config) + + + Initializes the layout renderer. + + + + + Try get the + + + + Renders the specified variable and appends it to the specified . @@ -9361,11 +10973,14 @@ - Decodes text "encrypted" with ROT-13. + Base class for s which wrapping other s. + + This has the property (which is default) and can be used to wrap. - - See http://en.wikipedia.org/wiki/ROT13. - + + ${uppercase:${level}} //[DefaultParameter] + ${uppercase:Inner=${level}} + @@ -9379,6 +10994,7 @@ Transforms the output of another layout. Output to be transform. + If the is needed, overwrite . Transformed text. @@ -9391,6 +11007,8 @@ Gets or sets the wrapped layout. + + [DefaultParameter] so Inner: is not required if it's the first @@ -9429,6 +11047,30 @@ + + + Gets or sets a value indicating when the cache is cleared. + + + + + Cachekey. If the cachekey changes, resets the value. For example, the cachekey would be the current day.s + + + + + A value indicating when the cache is cleared. + + + + Never clear the cache. + + + Clear the cache whenever the is initialized. + + + Clear the cache whenever the is closed. + Filters characters not allowed in the file names by replacing them with safe character. @@ -9597,6 +11239,9 @@ Replaces a string in the output of another layout with another string. + + ${replace:searchFor=\\n+:replaceWith=-:regex=true:inner=${message}} + @@ -9614,11 +11259,11 @@ A match evaluator for Regular Expression based replacing - - - - - + Input string. + Group name in the regex. + Replace value. + Match from regex. + Groups replaced with . @@ -9748,6 +11393,11 @@ Converts the result of another layout output to upper case. + + ${uppercase:${level}} //[DefaultParameter] + ${uppercase:Inner=${level}} + ${level:uppercase} // [AmbientProperty] + @@ -9798,6 +11448,20 @@ A value of true if space should be translated to '+'; otherwise, false. + + + Gets or sets a value whether escaping be done according to Rfc3986 (Supports Internationalized Resource Identifiers - IRIs) + + A value of true if Rfc3986; otherwise, false for legacy Rfc2396. + + + + + Gets or sets a value whether escaping be done according to the old NLog style (Very non-standard) + + A value of true if legacy encoding; otherwise, false for standard UTF8 encoding. + + Outputs alternative layout when the inner layout produces empty result. @@ -9848,10 +11512,41 @@ - Gets or sets the condition that must be met for the inner layout to be printed. + Gets or sets the condition that must be met for the layout to be printed. + + + If is not met, print this layout. + + + + + Replaces newline characters from the result of another layout renderer with spaces. + + + + + Initializes a new instance of the class. + + + + + Post-processes the rendered message. + + The text to be post-processed. + Post-processed text. + + + + Gets or sets the line length for wrapping. + + + Only positive values are allowed + + + Converts the result of another layout output to be XML-compliant. @@ -9875,6 +11570,168 @@ + + + A layout containing one or more nested layouts. + + + + + Abstract interface that layouts must implement. + + + + + Is this layout initialized? See + + + + + Does the layout contains threadAgnostic layout renders? If contains non-threadAgnostic-layoutrendender, then this layout is also not threadAgnostic. + See and . + + + + + Converts a given text to a . + + Text to be converted. + object represented by the text. + + + + Implicitly converts the specified string to a . + + The layout string. + Instance of . + + + + Implicitly converts the specified string to a . + + The layout string. + The NLog factories to use when resolving layout renderers. + Instance of . + + + + Precalculates the layout for the specified log event and stores the result + in per-log event cache. + + Only if the layout doesn't have [ThreadAgnostic] and doens't contain layouts with [ThreadAgnostic]. + + The log event. + + Calling this method enables you to store the log event in a buffer + and/or potentially evaluate it in another thread even though the + layout may contain thread-dependent renderer. + + + + + Renders the event info in layout. + + The event info. + String representing log event. + + + + Initializes this instance. + + The configuration. + + + + Closes this instance. + + + + + Initializes this instance. + + The configuration. + + + + Closes this instance. + + + + + Initializes the layout. + + + + + Closes the layout. + + + + + Renders the layout for the specified logging event by invoking layout renderers. + + The logging event. + The rendered layout. + + + + Register a custom Layout. + + Short-cut for registing to default + Type of the Layout. + Name of the Layout. + + + + Register a custom Layout. + + Short-cut for registing to default + Type of the Layout. + Name of the Layout. + + + + Gets a value indicating whether this layout is thread-agnostic (can be rendered on any thread). + + + Layout is thread-agnostic if it has been marked with [ThreadAgnostic] attribute and all its children are + like that as well. + Thread-agnostic layouts only use contents of for its output. + + + + + Gets the logging configuration this target is part of. + + + + + Initializes a new instance of the class. + + + + + Initializes the layout. + + + + + Formats the log event relying on inner layouts. + + The log event to be formatted. + A string representation of the log event. + + + + Closes the layout. + + + + + Gets the inner layouts. + + + A column in the CSV. @@ -9948,112 +11805,13 @@ A specialized layout that renders CSV-formatted events. + If is set, then the header generation with columnnames will be disabled. A specialized layout that supports header and footer. - - - Abstract interface that layouts must implement. - - - - - Converts a given text to a . - - Text to be converted. - object represented by the text. - - - - Implicitly converts the specified string to a . - - The layout string. - Instance of . - - - - Implicitly converts the specified string to a . - - The layout string. - The NLog factories to use when resolving layout renderers. - Instance of . - - - - Precalculates the layout for the specified log event and stores the result - in per-log event cache. - - The log event. - - Calling this method enables you to store the log event in a buffer - and/or potentially evaluate it in another thread even though the - layout may contain thread-dependent renderer. - - - - - Renders the event info in layout. - - The event info. - String representing log event. - - - - Initializes this instance. - - The configuration. - - - - Closes this instance. - - - - - Initializes this instance. - - The configuration. - - - - Closes this instance. - - - - - Initializes the layout. - - - - - Closes the layout. - - - - - Renders the layout for the specified logging event by invoking layout renderers. - - The logging event. - The rendered layout. - - - - Gets a value indicating whether this layout is thread-agnostic (can be rendered on any thread). - - - Layout is thread-agnostic if it has been marked with [ThreadAgnostic] attribute and all its children are - like that as well. - Thread-agnostic layouts only use contents of for its output. - - - - - Gets the logging configuration this target is part of. - - Renders the layout for the specified logging event by invoking layout renderers. @@ -10096,6 +11854,12 @@ The log event to be formatted. A string representation of the log event. + + + Get the headers with the column names. + + + Gets the array of parameters to be passed. @@ -10135,7 +11899,7 @@ - Header for CSV layout. + Header with column names for CSV layout. @@ -10240,6 +12004,21 @@ Gets or sets the option to suppress the extra spaces in the output json + + + Gets or sets the option to render the empty object value {} + + + + + Gets or sets the option to include all properties from the log events + + + + + List of property names to exclude when is true + + Marks class as a layout renderer and assigns a format string to it. @@ -10355,6 +12134,11 @@ A that represents the current object. + + + Initializes the layout. + + Renders the layout for the specified logging event by invoking layout renderers @@ -10389,6 +12173,12 @@ Gets a collection of objects that make up this layout. + + + Gets the level of stack trace information required for rendering. + + Calculated when setting . + Represents the logging event. @@ -10478,6 +12268,7 @@ The message. The exception. Instance of . + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -10573,6 +12364,7 @@ Gets the logger short name. + This property was marked as obsolete on NLog 2.0 and it may be removed in a future release. @@ -10595,6 +12387,11 @@ Gets the formatted message. + + + Checks if any per-event context properties (Without allocation) + + Gets the dictionary of per-event context properties. @@ -10604,12 +12401,19 @@ Gets the dictionary of per-event context properties. + This property was marked as obsolete on NLog 2.0 and it may be removed in a future release. Creates and manages instances of objects. + + + Overwrite possible file paths (including filename) for possible NLog config files. + When this property is null, the default file paths ( are used. + + Initializes a new instance of the class. @@ -10635,19 +12439,27 @@ - Gets the logger named after the currently-being-initialized class. + Gets the logger with the name of the current class. The logger. This is a slow-running method. Make sure you're not doing this in a loop. + + + Gets the logger with the name of the current class. + + The logger with type . + Type of the logger + This is a slow-running method. + Make sure you're not doing this in a loop. + - Gets the logger named after the currently-being-initialized class. + Gets a custom logger with the name of the current class. Use to pass the type of the needed Logger. - The type of the logger to create. The type must inherit from - NLog.Logger. - The logger. + The type of the logger to create. The type must inherit from + The logger of type . This is a slow-running method. Make sure you are not calling this method in a loop. @@ -10659,13 +12471,22 @@ The logger reference. Multiple calls to GetLogger with the same argument are not guaranteed to return the same logger reference. - + Gets the specified named logger. Name of the logger. - The type of the logger to create. The type must inherit from NLog.Logger. - The logger reference. Multiple calls to GetLogger with the + Type of the logger + The logger reference with type . Multiple calls to GetLogger with the same argument + are not guaranteed to return the same logger reference. + + + + Gets the specified named logger. Use to pass the type of the needed Logger. + + Name of the logger. + The type of the logger to create. The type must inherit from . + The logger of type . Multiple calls to GetLogger with the same argument aren't guaranteed to return the same logger reference. @@ -10677,7 +12498,7 @@ - Flush any pending log messages (in case of asynchronous targets). + Flush any pending log messages (in case of asynchronous targets) with the default timeout of 15 seconds. @@ -10722,6 +12543,8 @@ Logging is enabled if the number of calls is greater than or equal to calls. + + This method was marked as obsolete on NLog 4.0 and it may be removed in a future release. An object that implements IDisposable whose Dispose() method re-enables logging. To be used with C# using () statement. @@ -10732,7 +12555,10 @@ Logging is enabled if the number of calls is greater than - or equal to calls. + or equal to calls. + + This method was marked as obsolete on NLog 4.0 and it may be removed in a future release. + @@ -10763,10 +12589,21 @@ - Invoke the Changed event; called whenever list changes + Raises the event when the configuration is reloaded. Event arguments. + + + Raises the event when the configuration is reloaded. + + Event arguments + + + + Currently this logfactory is disposing? + + Releases unmanaged and - optionally - managed resources. @@ -10774,9 +12611,26 @@ True to release both managed and unmanaged resources; false to release only unmanaged resources. - + - Currenty this logfactory is disposing? + Get file paths (including filename) for the possible NLog config files. + + The filepaths to the possible config file + + + + Overwrite the paths (including filename) for the possible NLog config files. + + The filepaths to the possible config file + + + + Clear the candidate file paths and return to the defaults. + + + + + Get default file paths (including filename) for possible NLog config files. @@ -10796,19 +12650,39 @@ - Gets or sets a value indicating whether exceptions should be thrown. + Gets or sets a value indicating whether exceptions should be thrown. See also . A value of true if exception should be thrown; otherwise, false. By default exceptions are not thrown under any circumstances. + + + Gets or sets a value indicating whether should be thrown. + + If null then is used. + + A value of true if exception should be thrown; otherwise, false. + + This option is for backwards-compatiblity. + By default exceptions are not thrown under any circumstances. + + + + + Gets or sets a value indicating whether Variables should be kept on configuration reload. + Default value - false. + + - Gets or sets the current logging configuration. + Gets or sets the current logging configuration. After setting this property all + existing loggers will be re-configured, so there is no need to call + manually. - Gets or sets the global log threshold. Log events below this threshold are not logged. + Gets or sets the global log level threshold. Log events below this threshold are not logged. @@ -10882,16 +12756,16 @@ - Gets the logger. + Gets the logger with type . The logger name. An instance of . - Gets the logger named after the currently-being-initialized class. + Gets a custom logger with the name of the current class and type . - The logger. + An instance of . This is a slow-running method. Make sure you're not doing this in a loop. @@ -10976,6 +12850,7 @@ The log level. A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11008,6 +12883,7 @@ The log level. A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11099,66 +12975,73 @@ - Runs action. If the action throws, the exception is logged at Error level. Exception is not propagated outside of this method. + Runs the provided action. If the action throws, the exception is logged at Error level. The exception is not propagated outside of this method. Action to execute. - Runs the provided function and returns its result. If exception is thrown, it is logged at Error level. - Exception is not propagated outside of this method. Fallback value is returned instead. + Runs the provided function and returns its result. If an exception is thrown, it is logged at Error level. + The exception is not propagated outside of this method; a default value is returned instead. Return type of the provided function. Function to run. - Result returned by the provided function or fallback value in case of exception. + Result returned by the provided function or the default value of type in case of exception. - Runs the provided function and returns its result. If exception is thrown, it is logged at Error level. - Exception is not propagated outside of this method. Fallback value is returned instead. + Runs the provided function and returns its result. If an exception is thrown, it is logged at Error level. + The exception is not propagated outside of this method; a fallback value is returned instead. Return type of the provided function. Function to run. - Fallback value to return in case of exception. Defaults to default value of type T. + Fallback value to return in case of exception. Result returned by the provided function or fallback value in case of exception. + + + Logs an exception is logged at Error level if the provided task does not run to completion. + + The task for which to log an error if it does not run to completion. + This method is useful in fire-and-forget situations, where application logic does not depend on completion of task. This method is avoids C# warning CS4014 in such situations. + - If the task causes an exception or is canceled, the exception is logged at Error level. Exception is not propagated outside of this method. + Returns a task that completes when a specified task to completes. If the task does not run to completion, an exception is logged at Error level. The returned task always runs to completion. - Task for which to log an exception or cancellation. - A task that completes when after completes. - - This task returned by this method does not include a return value, even if is of type because the value is not present if the task causes an exception or is canceled. - If your code requires the return value, do not use this method to swallow the exception; instead, await the task normally and catch the exception to handle the case of no return value. - + The task for which to log an error if it does not run to completion. + A task that completes in the state when completes. - Runs async action. If the action causes an exception, or the task it returns causes an exception or is canceled, the exception is logged at Error level. Exception is not propagated outside of this method. + Runs async action. If the action throws, the exception is logged at Error level. The exception is not propagated outside of this method. Async action to execute. - Runs the provided async function and returns its result. - If the function causes an exception, or the task it returns causes an exception or is canceled, the exception is logged at Error level. - Exception is not propagated outside of this method. + Runs the provided async function and returns its result. If the task does not run to completion, an exception is logged at Error level. + The exception is not propagated outside of this method; a default value is returned instead. - Return type of the provided function. + Return type of the provided function. Async function to run. - Result returned by the provided task or a default value in case of exception. + A task that represents the completion of the supplied task. If the supplied task ends in the state, the result of the new task will be the result of the supplied task; otherwise, the result of the new task will be the default value of type . - Runs the provided async function and returns its result. - If the function causes an exception, or the task it returns causes an exception or is canceled, the exception is thrown, it is logged at Error level. - Exception is not propagated outside of this method. Fallback value is returned instead. + Runs the provided async function and returns its result. If the task does not run to completion, an exception is logged at Error level. + The exception is not propagated outside of this method; a fallback value is returned instead. - Return type of the provided function. + Return type of the provided function. Async function to run. - Fallback value to return in case of exception. Defaults to default value of type T. - Result returned by the provided function or fallback value in case of exception. + Fallback value to return if the task does not end in the state. + A task that represents the completion of the supplied task. If the supplied task ends in the state, the result of the new task will be the result of the supplied task; otherwise, the result of the new task will be the fallback value. + + + + Raises the event when the logger is reconfigured. + + Event arguments @@ -11190,6 +13073,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11218,6 +13102,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Trace level. + + A to be written. + An exception to be logged. @@ -11329,6 +13221,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11357,6 +13250,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Debug level. + + A to be written. + An exception to be logged. @@ -11468,6 +13369,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11496,6 +13398,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Info level. + + A to be written. + An exception to be logged. @@ -11607,6 +13517,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11635,6 +13546,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Warn level. + + A to be written. + An exception to be logged. @@ -11746,6 +13665,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11774,6 +13694,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Error level. + + A to be written. + An exception to be logged. @@ -11885,6 +13813,7 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -11913,6 +13842,14 @@ A to be written. An exception to be logged. + This method was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. + + + + Writes the diagnostic message and exception at the Fatal level. + + A to be written. + An exception to be logged. @@ -14270,23 +16207,35 @@ Finds first user stack frame in a stack trace The stack trace of the logging method invocation - Type of the logger or logger wrapper + Type of the logger or logger wrapper. This is still Logger if it's a subclass of Logger. Index of the first user stack frame or 0 if all stack frames are non-user - - + - Defines whether a stack frame belongs to non-user code + Get the index which correspondens to the calling method. + + This is most of the time the first index after . - Method of the stack frame - Type of the logger or logger wrapper - , if the method is from non-user code and should be skipped - - The method is classified as non-user if its declaring assembly is from hidden assemblies list - or its declaring type is or one of its subtypes. - + all the frames of the stacktrace + frames which all hiddenAssemblies are removed + index on stacktrace - + + + Assembly to skip? + + Find assembly via this frame. + true, we should skip. + + + + Is this the type of the logger? + + get type of this logger in this frame. + Type of the logger. + + + Gets the filter result. @@ -14294,6 +16243,28 @@ The log event. The result of the filter. + + + Stackframe with correspending index on the stracktrace + + + + + New item + + Index of on the stack. + A stackframe + + + + Index of on the stack. + + + + + A stackframe + + Defines available log levels. @@ -14459,6 +16430,17 @@ other ordinal. + + + Gets all the availiable log levels (Trace, Debug, Info, Warn, Error, Fatal, Off). + + + + + Gets all the log levels that can be used to log events (Trace, Debug, Info, Warn, Error, Fatal) + i.e LogLevel.Off is excluded. + + Gets the name of the log level. @@ -14486,7 +16468,7 @@ - Gets the logger named after the currently-being-initialized class. + Gets the logger with the name of the current class. The logger. This is a slow-running method. @@ -14501,10 +16483,10 @@ - Gets the logger named after the currently-being-initialized class. + Gets a custom logger with the name of the current class. Use to pass the type of the needed Logger. The logger class. The class must inherit from . - The logger. + The logger of type . This is a slow-running method. Make sure you're not doing this in a loop. @@ -14523,11 +16505,12 @@ - Gets the specified named logger. + Gets the specified named custom logger. Use to pass the type of the needed Logger. Name of the logger. The logger class. The class must inherit from . - The logger reference. Multiple calls to GetLogger with the same argument aren't guaranteed to return the same logger reference. + The logger of type . Multiple calls to GetLogger with the same argument aren't guaranteed to return the same logger reference. + The generic way for this method is @@ -14538,7 +16521,7 @@ - Flush any pending log messages (in case of asynchronous targets). + Flush any pending log messages (in case of asynchronous targets) with the default timeout of 15 seconds. @@ -14609,6 +16592,11 @@ namespace but not the assembly. + + + Gets the default instance. + + Occurs when logging changes. @@ -14625,9 +16613,27 @@ By default exceptions are not thrown under any circumstances. + + + Gets or sets a value indicating whether should be thrown. + + A value of true if exception should be thrown; otherwise, false. + + This option is for backwards-compatiblity. + By default exceptions are not thrown under any circumstances. + + + + + + Gets or sets a value indicating whether Variables should be kept on configuration reload. + Default value - false. + + Gets or sets the current logging configuration. + @@ -14639,11 +16645,13 @@ Gets or sets the default culture to use. + This property was marked as obsolete before NLog 4.3.11 and it may be removed in a future release. Delegate used to set/get the culture in use. + This delegate marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -14684,6 +16692,7 @@ Service contract for Log Receiver client. + This class marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -15024,8 +17033,11 @@ Log Receiver Client using WCF. - This will be removed when ILogReceiverClient is removed. - This provides an implementation of the legacy interface. + This class marked as obsolete before NLog 4.3.11 and it will be removed in a future release. + + It provides an implementation of the legacy interface and it will be completely obsolete when the + ILogReceiverClient is removed. + @@ -15033,6 +17045,7 @@ used internally (see internal constructor). It passes off any Channel usage to the inheriting class. + Type of the WCF service. @@ -15591,14 +17604,16 @@ Item name. The value of , if defined; otherwise . + If the value isn't a already, this call locks the for reading the needed for converting to . Gets the current thread MDC named item, as . Item name. - The to use when converting a value to a string. + The to use when converting a value to a . The value of , if defined; otherwise . + If is null and the value isn't a already, this call locks the for reading the needed for converting to . @@ -15607,6 +17622,12 @@ Item name. The value of , if defined; otherwise null. + + + Returns all item names + + A set of the names of all items in current thread-MDC. + Checks whether the specified item exists in current thread MDC. @@ -15636,12 +17657,21 @@ NLog library so that state can be maintained for multiple threads in asynchronous situations. + + + Simulate ImmutableDictionary behavior (which is not yet part of all .NET frameworks). + In future the real ImmutableDictionary could be used here to minimize memory usage and copying time. + + Must be true for any subsequent dictionary modification operation + + Gets the current logical context named item, as . Item name. The value of , if defined; otherwise . + If the value isn't a already, this call locks the for reading the needed for converting to . @@ -15650,6 +17680,7 @@ Item name. The to use when converting a value to a string. The value of , if defined; otherwise . + If is null and the value isn't a already, this call locks the for reading the needed for converting to . @@ -15672,6 +17703,12 @@ Item name. Item value. + + + Returns all item names + + A collection of the names of all items in current logical context. + Checks whether the specified exists in current logical context. @@ -15690,10 +17727,17 @@ Clears the content of current logical context. + + + Clears the content of current logical context. + + Free the full slot. + Mapped Diagnostics Context - used for log4net compatibility. + This class marked as obsolete before NLog 2.0 and it may be removed in a future release. @@ -15708,6 +17752,7 @@ Item name. The value of , if defined; otherwise . + If the value isn't a already, this call locks the for reading the needed for converting to . @@ -15738,6 +17783,7 @@ Nested Diagnostics Context - for log4net compatibility. + This class marked as obsolete on NLog 2.0 and it may be removed in a future release. @@ -15896,6 +17942,21 @@ The message. + + + Initializes a new instance of the class. + + The message. + Parameters for the message + + + + Initializes a new instance of the class. + + The inner exception. + The message. + Parameters for the message + Initializes a new instance of the class. @@ -16001,7 +18062,7 @@ - Flushes the output buffer. + Flushes the output (if is not true) buffer with the default timeout of 15 seconds. @@ -16123,6 +18184,20 @@ Gets or sets a value indicating whether to use auto logger name detected from the stack trace. + + + It works as a normal but it discards all messages which an application requests + to be logged. + + It effectively implements the "Null Object" pattern for objects. + + + + + Initializes a new instance of . + + The factory class to be used for the creation of this logger. + Specifies the way archive numbering is performed. @@ -16151,11 +18226,98 @@ The most recent archive has the highest number (in combination with the date). - + - Outputs log messages through the ASP Response object. + Sends log messages to the remote instance of Chainsaw application from log4j. - Documentation on NLog Wiki + Documentation on NLog Wiki + +

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

+ +

+ 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: +

+ +

+ NOTE: If your receiver application is ever likely to be off-line, don't use TCP protocol + or you'll get TCP timeouts and your application will crawl. + Either switch to UDP transport or use AsyncWrapper target + so that your application threads will not be blocked by the timing-out connection attempts. +

+ + + + + Sends log messages to the remote instance of NLog Viewer. + + Documentation on NLog Wiki + +

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

+ +

+ 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: +

+ +

+ NOTE: If your receiver application is ever likely to be off-line, don't use TCP protocol + or you'll get TCP timeouts and your application will crawl. + Either switch to UDP transport or use AsyncWrapper target + so that your application threads will not be blocked by the timing-out connection attempts. +

+ + + + + Sends log messages over the network. + + Documentation on NLog Wiki + +

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

+ +

+ 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: +

+ +

+ To print the results, use any application that's able to receive messages over + TCP or UDP. NetCat is + a simple but very powerful command-line tool that can be used for that. This image + demonstrates the NetCat tool receiving log messages from Network target. +

+ +

+ NOTE: If your receiver application is ever likely to be off-line, don't use TCP protocol + or you'll get TCP timeouts and your application will be very slow. + Either switch to UDP transport or use AsyncWrapper target + so that your application threads will not be blocked by the timing-out connection attempts. +

+

+ There are two specialized versions of the Network target: Chainsaw + and NLogViewer which write to instances of Chainsaw log4j viewer + or NLogViewer application respectively. +

+ @@ -16167,6 +18329,12 @@ Represents logging target. + + + Get all used layouts in this target. + + + Initializes this instance. @@ -16268,6 +18436,12 @@ Log event to be written out. + + + Writes a log event to the log target, in a thread safe manner. + + Log event to be written out. + Writes an array of logging events to the log target. By default it iterates on all @@ -16276,6 +18450,12 @@ Logging events to be written out. + + + Writes an array of logging events to the log target, in a thread safe manner. + + Logging events to be written out. + Merges (copies) the event context properties from any event info object stored in @@ -16283,6 +18463,22 @@ The event info object to perform the merge to. + + + Register a custom Target. + + Short-cut for registing to default + Type of the Target. + Name of the Target. + + + + Register a custom Target. + + Short-cut for registing to default + Type of the Target. + Name of the Target. + Gets or sets the name of the target. @@ -16318,111 +18514,6 @@ - - - Outputs the rendered logging event through the OutputDebugString() Win32 API. - - The logging event. - - - - Gets or sets a value indicating whether to add <!-- --> comments around all written texts. - - - - - - Sends log messages to the remote instance of Chainsaw application from log4j. - - Documentation on NLog Wiki - -

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

- -

- 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: -

- -

- NOTE: If your receiver application is ever likely to be off-line, don't use TCP protocol - or you'll get TCP timeouts and your application will crawl. - Either switch to UDP transport or use AsyncWrapper target - so that your application threads will not be blocked by the timing-out connection attempts. -

- - - - - Sends log messages to the remote instance of NLog Viewer. - - Documentation on NLog Wiki - -

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

- -

- 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: -

- -

- NOTE: If your receiver application is ever likely to be off-line, don't use TCP protocol - or you'll get TCP timeouts and your application will crawl. - Either switch to UDP transport or use AsyncWrapper target - so that your application threads will not be blocked by the timing-out connection attempts. -

- - - - - Sends log messages over the network. - - Documentation on NLog Wiki - -

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

- -

- 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: -

- -

- To print the results, use any application that's able to receive messages over - TCP or UDP. NetCat is - a simple but very powerful command-line tool that can be used for that. This image - demonstrates the NetCat tool receiving log messages from Network target. -

- -

- NOTE: If your receiver application is ever likely to be off-line, don't use TCP protocol - or you'll get TCP timeouts and your application will be very slow. - Either switch to UDP transport or use AsyncWrapper target - so that your application threads will not be blocked by the timing-out connection attempts. -

-

- There are two specialized versions of the Network target: Chainsaw - and NLogViewer which write to instances of Chainsaw log4j viewer - or NLogViewer application respectively. -

- - Initializes a new instance of the class. @@ -16431,6 +18522,15 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Flush any pending log messages asynchronously (in case of asynchronous targets). @@ -16449,6 +18549,15 @@ The logging event. + + + Try to remove. + + + + + removed something? + Gets the bytes to be written. @@ -16488,6 +18597,12 @@ + + + Gets or sets the end of line value if a newline is appended at the end of log message . + + + Gets or sets the maximum message size in bytes. @@ -16500,6 +18615,18 @@ + + + Gets or sets the maximum current connections. 0 = no maximum. + + + + + + Gets or sets the action that should be taken if the will be more connections than . + + + Gets or sets the maximum queue size. @@ -16526,6 +18653,15 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Gets or sets a value indicating whether to include NLog-specific extensions to log4j schema. @@ -16591,6 +18727,12 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class with a name. + + Name of the target. + Writes log messages to the console with customizable coloring. @@ -16634,6 +18776,23 @@ The layout with header and footer. + + + Should logging being paused/stopped because of the race condition bug in Console.Writeline? + + + Console.Out.Writeline / Console.Error.Writeline could throw 'IndexOutOfRangeException', which is a bug. + See http://stackoverflow.com/questions/33915790/console-out-and-console-error-race-condition-error-in-a-windows-service-written + and https://connect.microsoft.com/VisualStudio/feedback/details/2057284/console-out-probable-i-o-race-condition-issue-in-multi-threaded-windows-service + + Full error: + Error during session close: System.IndexOutOfRangeException: Probable I/ O race condition detected while copying memory. + The I/ O package is not thread safe by default.In multithreaded applications, + a stream must be accessed in a thread-safe way, such as a thread - safe wrapper returned by TextReader's or + TextWriter's Synchronized methods.This also applies to classes like StreamWriter and StreamReader. + + + Initializes a new instance of the class. @@ -16642,6 +18801,15 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Initializes the target. @@ -16717,6 +18885,13 @@ Has side effect + + + Gets or sets a value indicating whether to auto-check if the console is available. + - Disables console writing if Environment.UserInteractive = False (Windows Service) + - Disables console writing if Console Standard Input is not available (Non-Console-App) + + Gets the row highlighting rules. @@ -16907,6 +19082,41 @@ + + + Should logging being paused/stopped because of the race condition bug in Console.Writeline? + + + Console.Out.Writeline / Console.Error.Writeline could throw 'IndexOutOfRangeException', which is a bug. + See http://stackoverflow.com/questions/33915790/console-out-and-console-error-race-condition-error-in-a-windows-service-written + and https://connect.microsoft.com/VisualStudio/feedback/details/2057284/console-out-probable-i-o-race-condition-issue-in-multi-threaded-windows-service + + Full error: + Error during session close: System.IndexOutOfRangeException: Probable I/ O race condition detected while copying memory. + The I/ O package is not thread safe by default.In multithreaded applications, + a stream must be accessed in a thread-safe way, such as a thread - safe wrapper returned by TextReader's or + TextWriter's Synchronized methods.This also applies to classes like StreamWriter and StreamReader. + + + + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Initializes the target. @@ -16927,7 +19137,7 @@ Note that the Error option is not supported on .NET Compact Framework. - + Write to output @@ -16945,6 +19155,13 @@ Has side effect + + + Gets or sets a value indicating whether to auto-check if the console is available + - Disables console writing if Environment.UserInteractive = False (Windows Service) + - Disables console writing if Console Standard Input is not available (Non-Console-App) + + Highlighting rule for Win32 colorful console. @@ -16963,12 +19180,37 @@ Color of the foreground. Color of the background. + + + Get regex options. + + Default option to start with. + + + + + Get Expression for a . + + + + + + Replace regex result + + + + Gets or sets the regular expression to be matched. You must specify either text or regex. + + + Compile the ? This can improve the performance, but at the costs of more memory usage. If false, the Regex Cache is used. + + Gets or sets the text to be matched. You must specify either text or regex. @@ -16987,11 +19229,6 @@ - - - Gets the compiled regular expression that matches either Text or Regex property. - - Gets or sets the foreground color. @@ -17004,6 +19241,12 @@ + + + Gets the compiled regular expression that matches either Text or Regex property. Only used when is true. + + Access this property will compile the Regex. + Information about database command + parameters. @@ -17119,6 +19362,12 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + Performs installation which requires administrative permissions. @@ -17167,6 +19416,17 @@ Logging events to be written out. + + + Build the connectionstring from the properties. + + + Using at first, and falls back to the properties , + , and + + Event to render the layout inside the properties. + + Gets or sets the name of the database provider. @@ -17235,6 +19495,19 @@ + + + Obsolete - value will be ignored! The logging code always runs outside of transaction. + + Gets or sets a value indicating whether to use database transactions. + Some data providers require this. + + + + This option was removed in NLog 4.0 because the logging code always runs outside of transaction. + This ensures that the log gets written to the database if you rollback the main transaction because of an error and want to log the error. + + Gets or sets the database host name. If the ConnectionString is not provided @@ -17351,6 +19624,23 @@ + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Initializes the target. @@ -17396,6 +19686,15 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Increases the number of messages. @@ -17414,6 +19713,50 @@ + + + Default class for serialization of values to JSON format. + + + + + Interface for serialization of values, maybe even objects to JSON format. + Useful for wrappers for existing serializers. + + + + + Returns a serialization of an object + into JSON format. + + The object to serialize to JSON. + Serialized value. + + + + Returns a serialization of an object + int JSON format. + + The object to serialize to JSON. + Serialized value. + + + + Returns a serialization of an object + int JSON format. + + The object to serialize to JSON. + The objects in path. + The current depth (level) of recursion. + + Serialized value. + + + + + Singleton instance of the serializer. + + Writes log message to the Event Log. @@ -17445,6 +19788,12 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + Performs installation which requires administrative permissions. @@ -17544,6 +19893,39 @@ + + + Gets or sets the message length limit to write to the Event Log. + + MaxMessageLength cannot be zero or negative + + + + Gets or sets the action to take if the message is larger than the option. + + + + + + Action that should be taken if the message is greater than + the max message size allowed by the Event Log. + + + + + Truncate the message before writing to the Event Log. + + + + + Split the message and write multiple entries to the Event Log. + + + + + Discard of the message. It will not be written to the Event Log. + + Modes of archiving files based on time. @@ -17579,12 +19961,103 @@ AddToArchive every minute. + + + Type of filepath + + + + + Detect of relative or absolute + + + + + Relative path + + + + + Absolute path + + Best for performance + Writes log messages to one or more files. Documentation on NLog Wiki + + + Default clean up period of the initilized files. When a file exceeds the clean up period is removed from the list. + + Clean up period is defined in days. + + + + The maximum number of initialised files at any one time. Once this number is exceeded clean up procedures + are initiated to reduce the number of initialised files. + + + + + This value disables file archiving based on the size. + + + + + Holds the initialised files each given time by the instance. Against each file, the last write time is stored. + + Last write time is store in local time (no UTC). + + + + Factory used to create the file appenders in the instance. + + File appenders are stored in an instance of . + + + + List of the associated file appenders with the instance. + + + + + The number of initialised files at any one time. + + + + + The maximum number of archive files that should be kept. + + + + + It holds the file names of existing archives in order for the oldest archives to be removed when the list of + filenames becomes too long. + + + + + The filename as target + + + + + The archive file name as target + + + + + The date of the previous log event. + + + + + The file name of the previous log event. + + Initializes a new instance of the class. @@ -17593,6 +20066,22 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + + + + Refresh the ArchiveFilePatternToWatch option of the . + The log file must be watched for archiving when multiple processes are writing to the same + open file. + + Removes records of initialized files that have not been @@ -17622,6 +20111,15 @@ the needed functionality. + + + Returns the suitable appender factory ( ) to be used to generate the file + appenders associated with the instance. + + The type of the file appender factory returned depends on the values of various properties. + + suitable for this instance. + Initializes file logging by creating data structures that @@ -17640,6 +20138,13 @@ The logging event. + + + Get full filename (=absolute) and cleaned if needed. + + + + Writes the specified array of logging events to a file specified in the FileName @@ -17673,18 +20178,81 @@ The byte array. The modified byte array. The function can do the modification in-place. - + - Determines whether a file with a different name from is needed to receive . + Replaces the numeric pattern i.e. {#} in a file name with the parameter value. + File name which contains the numeric pattern. + Value which will replace the numeric pattern. + File name with the value of in the position of the numeric pattern. + + + + Determines if the file name as contains a numeric pattern i.e. {#} in it. + + Example: + trace{#}.log Contains the numeric pattern. + trace{###}.log Contains the numeric pattern. + trace{#X#}.log Contains the numeric pattern (See remarks). + trace.log Does not contain the pattern. + + Occasionally, this method can identify the existence of the {#} pattern incorrectly. + File name to be checked. + when the pattern is found; otherwise. + + + + Archives the using a rolling style numbering (the most recent is always #0 then + #1, ..., #N. When the number of archive files exceed the obsolete archives + are deleted. + + + This method is called recursively. This is the reason the is required. + + File name to be archived. + File name template which contains the numeric pattern to be replaced. + Value which will replace the numeric pattern. + + + + Archives the using a sequence style numbering. The most recent archive has the + highest number. When the number of archive files exceed the obsolete + archives are deleted. + + File name to be archived. + File name template which contains the numeric pattern to be replaced. + + + + Archives fileName to archiveFileName. + + File name to be archived. + Name of the archive file. + + + + + Archives the using a date and sequence style numbering. Archives will be stamped + with the prior period (Year, Month, Day) datetime. The most recent archive has the highest number (in + combination with the date). + + + When the number of archive files exceed the obsolete archives are deleted. + + + File name to be archived. + File name template which contains the numeric pattern to be replaced. + Log event that the instance is currently processing. - Deletes files among a given list, and stops as soon as the remaining files are fewer than the MaxArchiveFiles setting. + Deletes files among a given list, and stops as soon as the remaining files are fewer than the setting. + List of the file archives. - Items are deleted in the same order as in . - No file is deleted if MaxArchiveFile is equal to zero. + Items are deleted in the same order as in . No file is deleted if property is zero. @@ -17693,21 +20261,200 @@ An enumeration of archive infos, ordered by their file creation date. - + + + Parse filename with date and sequence pattern + + + dateformat for archive + + the found pattern. When failed, then default + the found pattern. When failed, then default + + + + + Gets the collection of files in the specified directory which they match the . + + Directory to searched. + Pattern which the files will be searched against. + List of files matching the pattern. + + + + Replaces the string-based pattern i.e. {#} in a file name with the value passed in parameter. + + File name which contains the string-based pattern. + Value which will replace the string-based pattern. + + File name with the value of in the position of the string-based pattern. + + + + + Archives the using a date style numbering. Archives will be stamped with the + prior period (Year, Month, Day, Hour, Minute) datetime. When the number of archive files exceed the obsolete archives are deleted. + + File name to be archived. + File name template which contains the numeric pattern to be replaced. + Log event that the instance is currently processing. + + Deletes archive files in reverse chronological order until only the MaxArchiveFiles number of archive files remain. The pattern that archive filenames will match - + + + Gets the correct formatting to be used based on the value of for converting values which will be inserting into file + names during archiving. + + This value will be computed only when a empty value or is passed into + + Date format to used irrespectively of value. + Formatting for dates. + + + + Invokes the archiving process after determining when and which type of archiving is required. + + File name to be checked and archived. + Log event that the instance is currently processing. + + Gets the pattern that archive files will match Filename of the log file - Log event info of the log that is currently been written + Log event that the instance is currently processing. A string with a pattern that will match the archive filenames + + + Determine if old archive files should be deleted. + + when old archives should be deleted; otherwise. + + + + Archives the file if it should be archived. + + The file name to check for. + Log event that the instance is currently processing. + The size in bytes of the next chunk of data to be written in the file. + + + + Indicates if the automatic archiving process should be executed. + + File name to be written. + Log event that the instance is currently processing. + The size in bytes of the next chunk of data to be written in the file. + Filename to archive. If null, then nothing to archive. + + + + Returns the correct filename to archive + + + + + + Gets the file name for archiving, or null if archiving should not occur based on file size. + + File name to be written. + The size in bytes of the next chunk of data to be written in the file. + Filename to archive. If null, then nothing to archive. + + + + Returns the file name for archiving, or null if archiving should not occur based on date/time. + + File name to be written. + Log event that the instance is currently processing. + Filename to archive. If null, then nothing to archive. + + + + The sequence of to be written for the file header. + + Sequence of to be written. + + + + The sequence of to be written for the file footer. + + Sequence of to be written. + + + + Evaluates which parts of a file should be written (header, content, footer) based on various properties of + instance and writes them. + + File name to be written. + Log event that the instance is currently processing. + Raw sequence of to be written into the content part of the file. + Indicates that only content section should be written in the file. + + + + Initialise a file to be used by the instance. Based on the number of initialised + files and the values of various instance properties clean up and/or archiving processes can be invoked. + + File name to be written. + Log event that the instance is currently processing. + Indicates that only content section should be written in the file. + when file header should be written; otherwise. + + + + Writes the file footer and finalizes the file in instance internal structures. + + File name to close. + Indicates if the file is being finalized for archiving. + + + + Writes the footer information to a file. + + The file path to write to. + + + + Invokes the archiving and clean up of older archive file based on the values of and properties respectively. + + File name to be written. + Log event that the instance is currently processing. + + + + Creates the file specified in and writes the file content in each entirety i.e. + Header, Content and Footer. + + The name of the file to be written. + Sequence of to be written in the content section of the file. + First attempt to write? + This method is used when the content of the log file is re-written on every write. + + + + Writes the header information to a file. + + File appender associated with the file. + + + + The sequence of to be written in a file after applying any formating and any + transformations required from the . + + The layout used to render output message. + Sequence of to be written. + Usually it is used to render the header and hooter of the files. + Gets or sets the name of the file to write to. @@ -17725,6 +20472,17 @@ + + + Cleanup invalid values in a filename, e.g. slashes in a filename. If set to true, this can impact the performance of massive writes. + If set to false, nothing gets written when the filename is wrong. + + + + + Is the an absolute or relative path? + + Gets or sets a value indicating whether to create directories if they do not exist. @@ -17744,16 +20502,6 @@ - - - Gets or sets a value indicating whether to archive old log file on startup. - - - This option works only when the "FileName" parameter denotes a single file. - After archiving the old file, the current log file will be empty. - - - Gets or sets a value indicating whether to replace file contents on each write instead of appending log message at the end. @@ -17776,6 +20524,8 @@ The bigger this number is the longer it will take to write each log record. The smaller the number is the higher the chance that the clean function will be run when no new files have been opened. + + [Warning] This method will be renamed to correct text casing i.e. MaxLogFilenames in NLog 5. @@ -17785,21 +20535,17 @@ - - - Gets or sets a value specifying the date format to use when archving files. - - - This option works only when the "ArchiveNumbering" parameter is set either to Date or DateAndSequence. - - - Gets or sets the file attributes (Windows only). + + + Should we capture the last write time of a file? + + Gets or sets the line ending mode. @@ -17892,6 +20638,25 @@ + + + Gets or sets a value indicating whether to archive old log file on startup. + + + This option works only when the "FileName" parameter denotes a single file. + After archiving the old file, the current log file will be empty. + + + + + + Gets or sets a value specifying the date format to use when archiving files. + + + This option works only when the "ArchiveNumbering" parameter is set either to Date or DateAndSequence. + + + Gets or sets the size in bytes above which log files will be automatically archived. @@ -17924,6 +20689,11 @@ + + + Is the an absolute or relative path? + + Gets or sets the name of the file to be used for an archive. @@ -17942,70 +20712,98 @@ - - - Gets or set a value indicating whether a managed file stream is forced, instead of used the native implementation. - - Gets or sets the way file archives are numbered. + + + Used to compress log files during archiving. + This may be used to provide your own implementation of a zip file compressor, + on platforms other than .Net4.5. + Defaults to ZipArchiveFileCompressor on .Net4.5 and to null otherwise. + + Gets or sets a value indicating whether to compress archive files into the zip archive format. + + + Gets or set a value indicating whether a managed file stream is forced, instead of using the native implementation. + + + + + Gets or sets a value indicationg whether file creation calls should be synchronized by a system global mutex. + + + + + Gets or sets a value indicating whether the footer should be written only when the file is archived. + + Gets the characters that are appended after each line. - + + + Creates an instance of class. + + The file target instance whose files to archive. + Maximum number of archive files to be kept. + + + + Adds the files in the specified path to the archive file queue. + + The folder where the archive files are stored. + + Adds a file into archive. File name of the archive Original file name Create a directory, if it does not exist - Enables file compression - true if the file has been moved successfully; false otherwise + if the file has been moved successfully; otherwise. - + - + Archives the file, either by copying it to a new file system location or by compressing it, and add the file name into the list of archives. - - - - + Target file name. + Original file name. + Create a directory, if it does not exist. - Remove old archive files when the files on the queue are more than the - MaxArchiveFilesToKeep. + Remove old archive files when the files on the queue are more than the . - + - Creates a new unique filename by appending a number to it. This method tests that - the filename created does not exist. - - This process can be slow as it increments the number sequentially from a specified - starting point until it finds a number which produces a filename which does not - exist. + Gets the file name for the next archive file by appending a number to the provided + "base"-filename. Example: Original Filename trace.log Target Filename trace.15.log - Original filename - Number starting point + Original file name. File name suitable for archiving + + + Gets or sets the maximum number of archive files that should be kept. + + Characters determining the start of the . @@ -18043,6 +20841,19 @@ when no pattern can be found. + + + may be configured to compress archived files in a custom way + by setting before logging your first event. + + + + + Create archiveFileName by compressing fileName. + + Absolute path to the log file to compress. + Absolute path to the compressed archive file to create. + Line ending mode. @@ -18183,6 +20994,12 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + Called when log events are being sent (test hook). @@ -18219,7 +21036,7 @@ Inheritors can override this method and provide their own service configuration - binding and endpoint address - + This method marked as obsolete before NLog 4.3.11 and it may be removed in a future release. @@ -18229,6 +21046,7 @@ service configuration - binding and endpoint address + virtual is used by endusers @@ -18318,6 +21136,15 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Renders the logging event message and adds it to the internal ArrayList of log messages. @@ -18336,7 +21163,7 @@ to initialize logging. - + Create mail and send with SMTP @@ -18353,10 +21180,18 @@ - Set propertes of + Set properties of last event for username/password client to set properties on + Configure not at , as the properties could have layout renderers. + + + + Handle if it is a virtual directory. + + + @@ -18387,6 +21222,13 @@ event for rendering the added a address? + + + Gets the mailSettings/smtp configuration from app.config in cases when we need those configuration. + E.g when UseSystemNetMailSettings is enabled and we need to read the From attribute from system.net/mailSettings/smtp + + Internal for mocking + Gets or sets sender's email address (e.g. joe@domain.com). @@ -18471,7 +21313,7 @@ Gets or sets a value indicating whether SSL (secure sockets layer) should be used when communicating with SMTP server. - + . @@ -18485,6 +21327,18 @@ + + + Specifies how outgoing email messages will be handled. + + + + + + Gets or sets the folder where applications save mail messages to be processed by the local SMTP server. + + + Gets or sets the priority used for sending mails. @@ -18531,6 +21385,15 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Renders the logging event message and adds it to the internal ArrayList of log messages. @@ -18650,6 +21513,17 @@ + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + Name of the target. + Initializes the target. @@ -18670,9 +21544,32 @@ Gets or sets the method name. The method must be public and static. + + Use the AssemblyQualifiedName , https://msdn.microsoft.com/en-us/library/system.type.assemblyqualifiedname(v=vs.110).aspx + e.g. + + + The action to be taken when there are more connections then the max. + + + + + Just allow it. + + + + + Discard the connection item. + + + + + Block until there's more room in the queue. + + Action that should be taken if the message overflows. @@ -18736,6 +21633,23 @@ + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Does nothing. Optionally it calculates the layout text but @@ -18770,6 +21684,23 @@ + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Outputs the rendered logging event through the OutputDebugString() Win32 API. @@ -18809,6 +21740,12 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + Performs installation which requires administrative permissions. @@ -18883,6 +21820,12 @@ + + + The value by which to increment the counter. + + + SMTP authentication modes. @@ -18907,6 +21850,7 @@ Marks class as a logging target and assigns a name to it. + This attribute is not required when registering the target in the API. @@ -18945,6 +21889,23 @@ + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + Name of the target. + Writes the specified logging event to the facility. @@ -18979,6 +21940,16 @@ Use HTTP GET Protocol. + + + Do an HTTP POST of a JSON document. + + + + + Do an HTTP POST of an XML document. + + Calls the specified web service on each log message. @@ -19005,11 +21976,23 @@ + + + dictionary that maps a concrete implementation + to a specific -value. + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target + Calls the target method. Must be implemented in concrete classes. @@ -19023,14 +22006,11 @@ Parameters to be passed. The continuation. - + - Helper for creating soap POST-XML request + Builds the URL to use when calling the web service for a message, depending on the WebServiceProtocol. - - - @@ -19079,6 +22059,45 @@ + + + Gets or sets a value whether escaping be done according to Rfc3986 (Supports Internationalized Resource Identifiers - IRIs) + + A value of true if Rfc3986; otherwise, false for legacy Rfc2396. + + + + + Gets or sets a value whether escaping be done according to the old NLog style (Very non-standard) + + A value of true if legacy encoding; otherwise, false for standard UTF8 encoding. + + + + + Gets or sets the name of the root XML element, + if POST of XML document chosen. + If so, this property must not be null. + (see and ). + + + + + + Gets or sets the (optional) root namespace of the XML document, + if POST of XML document chosen. + (see and ). + + + + + + base class for POST formatters, that + implement former PrepareRequest() method, + that creates the content for + the requested kind of HTTP request + + Win32 file attributes. @@ -19186,13 +22205,14 @@ action is taken as specified by . The log event info. + Queue was empty before enqueue Dequeues a maximum of count items from the queue and adds returns the list containing them. - Maximum number of items to be dequeued. + Maximum number of items to be dequeued (-1 means everything). The array of log events. @@ -19288,6 +22308,13 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The wrapped target. + Initializes a new instance of the class. @@ -19304,7 +22331,7 @@ - Waits for the lazy writer thread to finish writing messages. + Schedules a flush of pending events in the queue (if any), followed by flushing the WrappedTarget. The asynchronous continuation. @@ -19324,9 +22351,16 @@ queued log messages. + + + Attempts to start an instant timer-worker-thread which can write + queued log messages. + + Returns true when scheduled a timer-worker-thread + - Starts the lazy writer thread. + Stops the lazy writer thread. @@ -19340,6 +22374,12 @@ to ensure that the log event can be processed in another thread. + + + Write to queue without locking + + + Gets or sets the number of log events that should be processed in a batch @@ -19393,7 +22433,8 @@ - Causes a flush after each write on a wrapped target. + Causes a flush on a wrapped target if LogEvent statisfies the . + If condition isn't set, flushes on each write. Documentation on NLog Wiki @@ -19401,12 +22442,12 @@ To set up the target in the configuration file, use the following syntax:

- +

The above examples assume just one target and a single rule. See below for a programmatic configuration that's equivalent to the above config file:

- + @@ -19417,6 +22458,16 @@ The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + + Initializes a new instance of the class. + + + The default value of the layout is: ${longdate}|${level:uppercase=true}|${logger}|${message} + + The wrapped target. + Name of the target + Initializes a new instance of the class. @@ -19426,10 +22477,17 @@ Forwards the call to the .Write() - and calls on it. + and calls on it if LogEvent satisfies + the flush condition or condition is null. Logging event to be written out. + + + Gets or sets the condition expression. Log events who meet this condition will cause + a flush on the wrapped target. + + A target that buffers log events and sends them in batches to the wrapped target. @@ -19441,6 +22499,13 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The wrapped target. + Initializes a new instance of the class. @@ -19464,7 +22529,7 @@ - Flushes pending events in the buffer (if any). + Flushes pending events in the buffer (if any), followed by flushing the WrappedTarget. The asynchronous continuation. @@ -19569,6 +22634,13 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The targets. + Initializes a new instance of the class. @@ -19647,6 +22719,14 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The wrapped target. + The condition. + Initializes a new instance of the class. @@ -19680,6 +22760,13 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The wrapped target. + Initializes a new instance of the class. @@ -19775,6 +22862,76 @@ Reverts the impersonation context. + + + Limits the number of messages written per timespan to the wrapped target. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + The name of the target. + The wrapped target. + + + + Initializes a new instance of the class. + + The wrapped target. + + + + Initializes a new instance of the class. + + The wrapped target. + Maximum number of messages written per interval. + Interval in which the maximum number of messages can be written. + + + + Initializes the target and resets the current Interval and . + + + + + Writes log event to the wrapped target if the current is lower than . + If the is already reached, no log event will be written to the wrapped target. + resets when the current is expired. + + Log event to be written out. + + + + Gets or sets the maximum allowed number of messages written per . + + + Messages received after has been reached in the current will be discarded. + + + + + Gets or sets the interval in which messages will be written up to the number of messages. + + + Messages received after has been reached in the current will be discarded. + + + + + Gets the DateTime when the current will be reset. + + + + + Gets the number of written in the current . + + Logon provider. @@ -19824,6 +22981,18 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + Name of the target. + The wrapped target. + Evaluates all filtering rules to find the first one that matches. @@ -19873,6 +23042,13 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The targets. + Initializes a new instance of the class. @@ -19910,6 +23086,14 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The wrapped target. + The repeat count. + Initializes a new instance of the class. @@ -19954,6 +23138,15 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The wrapped target. + The retry count. + The retry delay milliseconds. + Initializes a new instance of the class. @@ -20006,6 +23199,13 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The targets. + Initializes a new instance of the class. @@ -20144,6 +23344,13 @@ Initializes a new instance of the class. + + + Initializes a new instance of the class. + + Name of the target. + The targets. + Initializes a new instance of the class. @@ -20164,6 +23371,19 @@ Logging events to be written out. + + + Builtin IFileCompressor implementation utilizing the .Net4.5 specific + and is used as the default value for on .Net4.5. + So log files created via can be zipped when archived + w/o 3rd party zip library when run on .Net4.5 or higher. + + + + + Implements using the .Net4.5 specific + + Current local time retrieved directly from DateTime.Now. diff --git a/CMS_SC/bin/Newtonsoft.Json.xml b/CMS_SC/bin/Newtonsoft.Json.xml index 246ae3b..c719433 100644 --- a/CMS_SC/bin/Newtonsoft.Json.xml +++ b/CMS_SC/bin/Newtonsoft.Json.xml @@ -9,351 +9,23 @@ Represents a BSON Oid (object id). - - - Initializes a new instance of the class. - - The Oid value. - Gets or sets the value of the Oid. The value of the Oid. + + + Initializes a new instance of the class. + + The Oid value. + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. - - - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. - - - - - Initializes a new instance of the class with the specified . - - - - - Reads the next JSON token from the stream. - - true if the next token was read successfully; false if there are no more tokens to read. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a []. - - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Skips the children of the current token. - - - - - Sets the current token. - - The new token. - - - - Sets the current token and value. - - The new token. - The value. - - - - Sets the state based on current token type. - - - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - - - Releases unmanaged and - optionally - managed resources - - true to release both managed and unmanaged resources; false to release only unmanaged resources. - - - - Changes the to Closed. - - - - - Gets the current reader state. - - The current reader state. - - - - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. - - - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. - - - - - Gets or sets a value indicating whether multiple pieces of JSON content can - be read from a continuous stream without erroring. - - - true to support reading multiple pieces of JSON content; otherwise false. The default is false. - - - - - Gets the quotation mark character used to enclose the value of a string. - - - - - Get or set how time zones are handling when reading JSON. - - - - - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - - - - - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - - - - - Get or set how custom date formatted strings are parsed when reading JSON. - - - - - Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . - - - - - Gets the type of the current JSON token. - - - - - Gets the text value of the current JSON token. - - - - - Gets The Common Language Runtime (CLR) type for the current JSON token. - - - - - Gets the depth of the current token in the JSON document. - - The depth of the current token in the JSON document. - - - - Gets the path of the current JSON token. - - - - - Gets or sets the culture used when reading JSON. Defaults to . - - - - - Specifies the state of the reader. - - - - - The Read method has not been called. - - - - - The end of the file has been reached successfully. - - - - - Reader is at a property. - - - - - Reader is at the start of an object. - - - - - Reader is in an object. - - - - - Reader is at the start of an array. - - - - - Reader is in an array. - - - - - The Close method has been called. - - - - - Reader has just read a value. - - - - - Reader is at the start of a constructor. - - - - - Reader in a constructor. - - - - - An error occurred that prevents the read operation from continuing. - - - - - The end of the file has been reached successfully. - - - - - Initializes a new instance of the class. - - The stream. - - - - Initializes a new instance of the class. - - The reader. - - - - Initializes a new instance of the class. - - The stream. - if set to true the root object will be read as a JSON array. - The used when reading values from BSON. - - - - Initializes a new instance of the class. - - The reader. - if set to true the root object will be read as a JSON array. - The used when reading values from BSON. - - - - Reads the next JSON token from the stream as a []. - - - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. - - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - - A . This method will return null at the end of an array. - - - - - Reads the next JSON token from the stream. - - - true if the next token was read successfully; false if there are no more tokens to read. - - - - - Changes the to Closed. - - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. @@ -372,466 +44,62 @@ - Gets or sets the used when reading values from BSON. + Gets or sets the used when reading values from BSON. + + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The stream. + + + + Initializes a new instance of the class. + + The reader. + + + + Initializes a new instance of the class. + + The stream. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The reader. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Reads the next JSON token from the stream. + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Changes the to Closed. - The used when reading values from BSON. Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. - + - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. - - - - - Creates an instance of the JsonWriter class. - - - - - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. - - - - - Closes this stream and the underlying stream. - - - - - Writes the beginning of a JSON object. - - - - - Writes the end of a JSON object. - - - - - Writes the beginning of a JSON array. - - - - - Writes the end of an array. - - - - - Writes the start of a constructor with the given name. - - The name of the constructor. - - - - Writes the end constructor. - - - - - Writes the property name of a name/value pair on a JSON object. - - The name of the property. - - - - Writes the property name of a name/value pair on a JSON object. - - The name of the property. - A flag to indicate whether the text should be escaped when it is written as a JSON property name. - - - - Writes the end of the current JSON object or array. - - - - - Writes the current token and its children. - - The to read the token from. - - - - Writes the current token. - - The to read the token from. - A flag indicating whether the current token's children should be written. - - - - Writes the token and its value. - - The to write. - - The value to write. - A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . - - - - Writes the token. - - The to write. - - - - Writes the specified end token. - - The end token to write. - - - - Writes indent characters. - - - - - Writes the JSON value delimiter. - - - - - Writes an indent space. - - - - - Writes a null value. - - - - - Writes an undefined value. - - - - - Writes raw JSON without changing the writer's state. - - The raw JSON to write. - - - - Writes raw JSON where a value is expected and updates the writer's state. - - The raw JSON to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a [] value. - - The [] value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - An error will raised if the value cannot be written as a single JSON token. - - The value to write. - - - - Writes out a comment /*...*/ containing the specified text. - - Text to place inside the comment. - - - - Writes out the given white space. - - The string of white space characters. - - - - Sets the state of the JsonWriter, - - The JsonToken being written. - The value being written. - - - - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. - - - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. - - - - - Gets the top. - - The top. - - - - Gets the state of the writer. - - - - - Gets the path of the writer. - - - - - Indicates how JSON text output is formatted. - - - - - Get or set how dates are written to JSON text. - - - - - Get or set how time zones are handling when writing JSON text. - - - - - Get or set how strings are escaped when writing JSON text. - - - - - Get or set how special floating point numbers, e.g. , - and , - are written to JSON text. - - - - - Get or set how and values are formatting when writing JSON text. - - - - - Gets or sets the culture used when writing JSON. Defaults to . + Gets or sets the used when writing values to BSON. + When set to no conversion will occur. + The used when writing values to BSON. @@ -1051,13 +319,6 @@ The regex pattern. The regex options. - - - Gets or sets the used when writing values to BSON. - When set to no conversion will occur. - - The used when writing values to BSON. - Specifies how constructors are used when initializing objects during deserialization by the . @@ -1065,12 +326,12 @@ - First attempt to use the public default constructor, then fall back to single paramatized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. - Json.NET will use a non-public default constructor before falling back to a paramatized constructor. + Json.NET will use a non-public default constructor before falling back to a parameterized constructor. @@ -1078,61 +339,6 @@ Converts a binary value to and from a base 64 string value. - - - Converts an object to and from JSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - - Gets the of the JSON produced by the JsonConverter. - - - JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - - - The of the JSON produced by the JsonConverter. - - - - Gets a value indicating whether this can read JSON. - - true if this can read JSON; otherwise, false. - - - - Gets a value indicating whether this can write JSON. - - true if this can write JSON; otherwise, false. - Writes the JSON representation of the object. @@ -1427,24 +633,6 @@ Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - Gets or sets the date time styles used when converting a date to and from JSON. @@ -1463,6 +651,24 @@ The culture used when converting a date to and from JSON. + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). @@ -1555,11 +761,29 @@ Converts an to and from its name string value. + + + Gets or sets a value indicating whether the written enum text should be camel case. + + true if the written enum text will be camel case; otherwise, false. + + + + Gets or sets a value indicating whether integer values are allowed. + + true if integers are allowed; otherwise, false. + Initializes a new instance of the class. + + + Initializes a new instance of the class. + + true if the written enum text will be camel case; otherwise, false. + Writes the JSON representation of the object. @@ -1587,18 +811,6 @@ true if this instance can convert the specified object type; otherwise, false. - - - Gets or sets a value indicating whether the written enum text should be camel case. - - true if the written enum text will be camel case; otherwise, false. - - - - Gets or sets a value indicating whether integer values are allowed. - - true if integers are allowed; otherwise, false. - Converts a to and from a string (e.g. "1.2.3.4"). @@ -1636,6 +848,25 @@ Converts XML to and from JSON. + + + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. + + The name of the deserialize root element. + + + + Gets or sets a flag to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + true if the array attibute is written to the XML; otherwise, false. + + + + Gets or sets a value indicating whether to write the root JSON object. + + true if the JSON root object is omitted; otherwise, false. + Writes the JSON representation of the object. @@ -1660,7 +891,7 @@ Attribute name to test. The attribute name prefix if it has one, otherwise an empty string. - True if attribute name is for a namespace attribute, otherwise false. + true if attribute name is for a namespace attribute, otherwise false. @@ -1671,25 +902,6 @@ true if this instance can convert the specified value type; otherwise, false. - - - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. - - The name of the deserialize root element. - - - - Gets or sets a flag to indicate whether to write the Json.NET array attribute. - This attribute helps preserve arrays when converting the written XML back to JSON. - - true if the array attibute is written to the XML; otherwise, false. - - - - Gets or sets a value indicating whether to write the root JSON object. - - true if the JSON root object is omitted; otherwise, false. - Specifies how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. @@ -1771,8 +983,8 @@ Specifies default value handling options for the . - - + + @@ -1838,6 +1050,25 @@ Causes child objects to be indented according to the and settings. + + + Provides an interface for using pooled arrays. + + The array type content. + + + + Rent a array from the pool. This array must be returned when it is no longer needed. + + The minimum required length of the array. The returned array may be longer. + The rented array from the pool. This array must be returned when it is no longer needed. + + + + Return an array to the pool. + + The array that is being returned. + Provides an interface to enable a class to return line and position information. @@ -1868,22 +1099,39 @@ Instructs the how to serialize the collection. + + + Gets or sets a value indicating whether null items are allowed in the collection. + + true if null items are allowed in the collection; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a flag indicating whether the array can contain null items + + A flag indicating whether the array can contain null items. + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Instructs the to use the specified constructor when deserializing that object. + + Instructs the how to serialize the object. - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class with the specified container Id. - - The container Id. - Gets or sets the id. @@ -1904,21 +1152,38 @@ - Gets the collection's items converter. + Gets or sets the collection's items converter. The collection's items converter. - The parameter list to use when constructing the JsonConverter described by ItemConverterType. + The parameter list to use when constructing the described by ItemConverterType. If null, the default constructor is used. - When non-null, there must be a constructor defined in the JsonConverter that exactly matches the number, + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by NamingStrategyType. + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + Gets or sets a value that indicates whether to preserve object references. @@ -1947,34 +1212,17 @@ The type name handling. - + - Initializes a new instance of the class. + Initializes a new instance of the class. - + - Initializes a new instance of the class with a flag indicating whether the array can contain null items - - A flag indicating whether the array can contain null items. - - - - Initializes a new instance of the class with the specified container Id. + Initializes a new instance of the class with the specified container Id. The container Id. - - - Gets or sets a value indicating whether null items are allowed in the collection. - - true if null items are allowed in the collection; otherwise, false. - - - - Instructs the to use the specified constructor when deserializing that object. - - Provides methods for converting between common language runtime types and JSON types. @@ -1983,6 +1231,15 @@ + + + Gets or sets a function that creates default . + Default settings are automatically used by serialization methods on , + and and on . + To serialize without using any default settings create a with + . + + Represents JavaScript's boolean value true as a string. This field is read-only. @@ -2616,44 +1873,90 @@ The deserialized XNode - + - Gets or sets a function that creates default . - Default settings are automatically used by serialization methods on , - and and on . - To serialize without using any default settings create a with - . + Converts an object to and from JSON. + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + + Gets the of the JSON produced by the JsonConverter. + + + JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. + + + The of the JSON produced by the JsonConverter. + + + + Gets a value indicating whether this can read JSON. + + true if this can read JSON; otherwise, false. + + + + Gets a value indicating whether this can write JSON. + + true if this can write JSON; otherwise, false. + Instructs the to use the specified when serializing the member or class. + + + Gets the of the . + + The of the . + + + + The parameter list to use when constructing the described by ConverterType. + If null, the default constructor is used. + + Initializes a new instance of the class. - Type of the converter. + Type of the . Initializes a new instance of the class. - Type of the converter. - Parameter list to use when constructing the JsonConverter. Can be null. - - - - Gets the of the converter. - - The of the converter. - - - - The parameter list to use when constructing the JsonConverter described by ConverterType. - If null, the default constructor is used. - + Type of the . + Parameter list to use when constructing the . Can be null. @@ -2716,11 +2019,6 @@ and write values during serialization. - - - Initializes a new instance of the class. - - Gets or sets a value that indicates whether to write extension data when serializing the object. @@ -2737,6 +2035,11 @@ true to read extension data when deserializing the object; otherwise, false. The default is true. + + + Initializes a new instance of the class. + + Instructs the not to serialize the public field or public read/write property value. @@ -2747,6 +2050,20 @@ Instructs the how to serialize the object. + + + Gets or sets the member serialization. + + The member serialization. + + + + Gets or sets a value that indicates whether the object's properties are required. + + + A value indicating whether the object's properties are required. + + Initializes a new instance of the class. @@ -2764,53 +2081,45 @@ The container Id. - - - Gets or sets the member serialization. - - The member serialization. - - - - Gets or sets a value that indicates whether the object's properties are required. - - - A value indicating whether the object's properties are required. - - Instructs the to always serialize the member with the specified name. - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class with the specified name. - - Name of the property. - - Gets or sets the converter used when serializing the property's collection items. + Gets or sets the used when serializing the property's collection items. - The collection's items converter. + The collection's items . - The parameter list to use when constructing the JsonConverter described by ItemConverterType. + The parameter list to use when constructing the described by ItemConverterType. If null, the default constructor is used. - When non-null, there must be a constructor defined in the JsonConverter that exactly matches the number, + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by NamingStrategyType. + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + Gets or sets the null value handling used when serializing this property. @@ -2849,9 +2158,9 @@ - Gets or sets the order of serialization and deserialization of a member. + Gets or sets the order of serialization of a member. - The numeric order of serialization or deserialization. + The numeric order of serialization. @@ -2885,11 +2194,299 @@ Whether this property's collection items are serialized as a reference. + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified name. + + Name of the property. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + + + Specifies the state of the reader. + + + + + The Read method has not been called. + + + + + The end of the file has been reached successfully. + + + + + Reader is at a property. + + + + + Reader is at the start of an object. + + + + + Reader is in an object. + + + + + Reader is at the start of an array. + + + + + Reader is in an array. + + + + + The Close method has been called. + + + + + Reader has just read a value. + + + + + Reader is at the start of a constructor. + + + + + Reader in a constructor. + + + + + An error occurred that prevents the read operation from continuing. + + + + + The end of the file has been reached successfully. + + + + + Gets the current reader state. + + The current reader state. + + + + Gets or sets a value indicating whether the underlying stream or + should be closed when the reader is closed. + + + true to close the underlying stream or when + the reader is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether multiple pieces of JSON content can + be read from a continuous stream without erroring. + + + true to support reading multiple pieces of JSON content; otherwise false. The default is false. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + Get or set how time zones are handling when reading JSON. + + + + + Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + + + + + Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + + + + + Get or set how custom date formatted strings are parsed when reading JSON. + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + + + + + Gets the type of the current JSON token. + + + + + Gets the text value of the current JSON token. + + + + + Gets The Common Language Runtime (CLR) type for the current JSON token. + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets or sets the culture used when reading JSON. Defaults to . + + + + + Initializes a new instance of the class with the specified . + + + + + Reads the next JSON token from the stream. + + true if the next token was read successfully; false if there are no more tokens to read. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a []. + + A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Skips the children of the current token. + + + + + Sets the current token. + + The new token. + + + + Sets the current token and value. + + The new token. + The value. + + + + Sets the state based on current token type. + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Releases unmanaged and - optionally - managed resources + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Changes the to Closed. + + The exception thrown when an error occurs while reading JSON text. + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + Initializes a new instance of the class. @@ -2919,24 +2516,6 @@ The parameter is null. The class name is null or is zero (0). - - - Gets the line number indicating where the error occurred. - - The line number indicating where the error occurred. - - - - Gets the line position indicating where the error occurred. - - The line position indicating where the error occurred. - - - - Gets the path to the JSON where the error occurred. - - The path to the JSON where the error occurred. - Instructs the to always serialize the member, and require the member has a value. @@ -2982,143 +2561,6 @@ The enables you to control how objects are encoded into JSON. - - - Initializes a new instance of the class. - - - - - Creates a new instance. - The will not use default settings. - - - A new instance. - The will not use default settings. - - - - - Creates a new instance using the specified . - The will not use default settings. - - The settings to be applied to the . - - A new instance using the specified . - The will not use default settings. - - - - - Creates a new instance. - The will use default settings. - - - A new instance. - The will use default settings. - - - - - Creates a new instance using the specified . - The will use default settings. - - The settings to be applied to the . - - A new instance using the specified . - The will use default settings. - - - - - Populates the JSON values onto the target object. - - The that contains the JSON structure to reader values from. - The target object to populate values onto. - - - - Populates the JSON values onto the target object. - - The that contains the JSON structure to reader values from. - The target object to populate values onto. - - - - Deserializes the JSON structure contained by the specified . - - The that contains the JSON structure to deserialize. - The being deserialized. - - - - Deserializes the JSON structure contained by the specified - into an instance of the specified type. - - The containing the object. - The of object being deserialized. - The instance of being deserialized. - - - - Deserializes the JSON structure contained by the specified - into an instance of the specified type. - - The containing the object. - The type of the object to deserialize. - The instance of being deserialized. - - - - Deserializes the JSON structure contained by the specified - into an instance of the specified type. - - The containing the object. - The of object being deserialized. - The instance of being deserialized. - - - - Serializes the specified and writes the JSON structure - to a Stream using the specified . - - The used to write the JSON structure. - The to serialize. - - - - Serializes the specified and writes the JSON structure - to a Stream using the specified . - - The used to write the JSON structure. - The to serialize. - - The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. - - - - - Serializes the specified and writes the JSON structure - to a Stream using the specified . - - The used to write the JSON structure. - The to serialize. - - The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. - - - - - Serializes the specified and writes the JSON structure - to a Stream using the specified . - - The used to write the JSON structure. - The to serialize. - Occurs when the errors during serialization and deserialization. @@ -3150,6 +2592,11 @@ Gets or sets how type name writing and reading is handled by the serializer. + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than TypeNameHandling.None. + @@ -3278,16 +2725,156 @@ true if there will be a check for additional JSON content after deserializing an object; otherwise, false. + + + Initializes a new instance of the class. + + + + + Creates a new instance. + The will not use default settings + from . + + + A new instance. + The will not use default settings + from . + + + + + Creates a new instance using the specified . + The will not use default settings + from . + + The settings to be applied to the . + + A new instance using the specified . + The will not use default settings + from . + + + + + Creates a new instance. + The will use default settings + from . + + + A new instance. + The will use default settings + from . + + + + + Creates a new instance using the specified . + The will use default settings + from as well as the specified . + + The settings to be applied to the . + + A new instance using the specified . + The will use default settings + from as well as the specified . + + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to reader values from. + The target object to populate values onto. + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to reader values from. + The target object to populate values onto. + + + + Deserializes the JSON structure contained by the specified . + + The that contains the JSON structure to deserialize. + The being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The type of the object to deserialize. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Serializes the specified and writes the JSON structure + to a Stream using the specified . + + The used to write the JSON structure. + The to serialize. + + + + Serializes the specified and writes the JSON structure + to a Stream using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is Auto to write out the type name if the type of the value does not match. + Specifing the type is optional. + + + + + Serializes the specified and writes the JSON structure + to a Stream using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is Auto to write out the type name if the type of the value does not match. + Specifing the type is optional. + + + + + Serializes the specified and writes the JSON structure + to a Stream using the specified . + + The used to write the JSON structure. + The to serialize. + Specifies the settings on a object. - - - Initializes a new instance of the class. - - Gets or sets how reference loops (e.g. a class referencing itself) is handled. @@ -3320,7 +2907,7 @@ - Gets or sets a collection that will be used during serialization. + Gets or sets a collection that will be used during serialization. The converters. @@ -3334,6 +2921,11 @@ Gets or sets how type name writing and reading is handled by the serializer. + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than TypeNameHandling.None. + The type name handling. @@ -3463,6 +3055,11 @@ true if there will be a check for additional content after deserializing an object; otherwise, false. + + + Initializes a new instance of the class. + + Represents a reader that provides fast, non-cached, forward-only access to JSON text data. @@ -3474,29 +3071,26 @@ The TextReader containing the XML data to read. + + + Gets or sets the reader's character buffer pool. + + Reads the next JSON token from the stream. - true if the next token was read successfully; false if there are no more tokens to read. + true if the next token was read successfully; false if there are no more tokens to read. - - - Reads the next JSON token from the stream as a []. - - - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. - - - + Reads the next JSON token from the stream as a . A . This method will return null at the end of an array. - + Reads the next JSON token from the stream as a . @@ -3508,17 +3102,35 @@ A . This method will return null at the end of an array. - + + + Reads the next JSON token from the stream as a []. + + A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + + Reads the next JSON token from the stream as a . - A . This method will return null at the end of an array. + A . This method will return null at the end of an array. Reads the next JSON token from the stream as a . - A . This method will return null at the end of an array. + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. @@ -3554,6 +3166,31 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Gets or sets the writer's character array pool. + + + + + Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + + + + + Gets or sets which character to use to quote attribute values. + + + + + Gets or sets which character to use for indenting when is set to Formatting.Indented. + + + + + Gets or sets a value indicating whether object names will be surrounded with quotes. + + Creates an instance of the JsonWriter class using the specified . @@ -3787,26 +3424,6 @@ The string of white space characters. - - - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. - - - - - Gets or sets which character to use to quote attribute values. - - - - - Gets or sets which character to use for indenting when is set to Formatting.Indented. - - - - - Gets or sets a value indicating whether object names will be surrounded with quotes. - - Specifies the type of JSON token. @@ -3912,59 +3529,6 @@ - - - Initializes a new instance of the class that - validates the content returned from the given . - - The to read from while validating. - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream as a []. - - - A [] or a null reference if the next JSON token is null. - - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream. - - - true if the next token was read successfully; false if there are no more tokens to read. - - Sets an event handler for receiving schema validation errors. @@ -4005,6 +3569,13 @@ + + + Initializes a new instance of the class that + validates the content returned from the given . + + The to read from while validating. + Gets or sets the schema. @@ -4017,11 +3588,533 @@ The specified in the constructor. + + + Reads the next JSON token from the stream as a . + + A . + + + + Reads the next JSON token from the stream as a []. + + + A [] or a null reference if the next JSON token is null. + + + + + Reads the next JSON token from the stream as a . + + A . + + + + Reads the next JSON token from the stream as a . + + A . + + + + Reads the next JSON token from the stream as a . + + A . + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the stream as a . + + A . + + + + Reads the next JSON token from the stream. + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets or sets a value indicating whether the underlying stream or + should be closed when the writer is closed. + + + true to close the underlying stream or when + the writer is closed; otherwise false. The default is true. + + + + + Gets the top. + + The top. + + + + Gets the state of the writer. + + + + + Gets the path of the writer. + + + + + Indicates how JSON text output is formatted. + + + + + Get or set how dates are written to JSON text. + + + + + Get or set how time zones are handling when writing JSON text. + + + + + Get or set how strings are escaped when writing JSON text. + + + + + Get or set how special floating point numbers, e.g. , + and , + are written to JSON text. + + + + + Get or set how and values are formatting when writing JSON text. + + + + + Gets or sets the culture used when writing JSON. Defaults to . + + + + + Creates an instance of the JsonWriter class. + + + + + Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + + + + + Closes this stream and the underlying stream. + + + + + Writes the beginning of a JSON object. + + + + + Writes the end of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the end of an array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the end constructor. + + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + + + + Writes the end of the current JSON object or array. + + + + + Writes the current token and its children. + + The to read the token from. + + + + Writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + + + + Writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + A null value can be passed to the method for token's that don't have a value, e.g. . + + + + Writes the token. + + The to write. + + + + Writes the specified end token. + + The end token to write. + + + + Writes indent characters. + + + + + Writes the JSON value delimiter. + + + + + Writes an indent space. + + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON without changing the writer's state. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes out a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes out the given white space. + + The string of white space characters. + + + + Releases unmanaged and - optionally - managed resources + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Sets the state of the JsonWriter, + + The JsonToken being written. + The value being written. + The exception thrown when an error occurs while reading JSON text. + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + Initializes a new instance of the class. @@ -4051,11 +4144,35 @@ The parameter is null. The class name is null or is zero (0). - + - Gets the path to the JSON where the error occurred. + Specifies how JSON comments are handled when loading JSON. + + + + + Ignore comments. + + + + + Load comments as a with type . + + + + + Specifies how line information is handled when loading JSON. + + + + + Ignore line information. + + + + + Load line information. - The path to the JSON where the error occurred. @@ -4202,23 +4319,1071 @@ + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Loads an from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads an from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the at the specified index. + + + + + + Determines the index of a specific item in the . + + The object to locate in the . + + The index of if found in the list; otherwise, -1. + + + + + Inserts an item to the at the specified index. + + The zero-based index at which should be inserted. + The object to insert into the . + + is not a valid index in the . + The is read-only. + + + + Removes the item at the specified index. + + The zero-based index of the item to remove. + + is not a valid index in the . + The is read-only. + + + + Returns an enumerator that iterates through the collection. + + + A that can be used to iterate through the collection. + + + + + Adds an item to the . + + The object to add to the . + The is read-only. + + + + Removes all items from the . + + The is read-only. + + + + Determines whether the contains a specific value. + + The object to locate in the . + + true if is found in the ; otherwise, false. + + + + + Copies to. + + The array. + Index of the array. + + + + Gets a value indicating whether the is read-only. + + true if the is read-only; otherwise, false. + + + + Removes the first occurrence of a specific object from the . + + The object to remove from the . + + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + + The is read-only. + + + + Represents a JSON constructor. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets or sets the name of this constructor. + + The constructor name. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name. + + The constructor name. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Loads an from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads an from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + Represents a token that can contain other tokens. + + + Occurs when the list changes or an item in the list changes. + + + + + Occurs before an item is added to the collection. + + + + + Occurs when the items list of the collection has changed, or the collection is reset. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Get the first child token of this token. + + + A containing the first child token of the . + + + + + Get the last child token of this token. + + + A containing the last child token of the . + + + + + Returns a collection of the child tokens of this token, in document order. + + + An of containing the child tokens of this , in document order. + + + + + Returns a collection of the child values of this token, in document order. + + The type to convert the values to. + + A containing the child values of this , in document order. + + + + + Returns a collection of the descendant tokens for this token in document order. + + An containing the descendant tokens of the . + + + + Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. + + An containing this token, and all the descendant tokens of the . + + + + Adds the specified content as children of this . + + The content to be added. + + + + Adds the specified content as the first children of this . + + The content to be added. + + + + Creates an that can be used to add tokens to the . + + An that is ready to have content written to it. + + + + Replaces the children nodes of this token with the specified content. + + The content. + + + + Removes the child nodes from this token. + + + + + Merge the specified content into this . + + The content to be merged. + + + + Merge the specified content into this using . + + The content to be merged. + The used to merge the content. + + + + Gets the count of child JSON tokens. + + The count of child JSON tokens + + + + Represents a collection of objects. + + The type of token + + + + An empty collection of objects. + + + + + Initializes a new instance of the struct. + + The enumerable. + + + + Returns an enumerator that iterates through the collection. + + + A that can be used to iterate through the collection. + + + + + Returns an enumerator that iterates through a collection. + + + An object that can be used to iterate through the collection. + + + + + Gets the with the specified key. + + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. + + + + + Represents a JSON object. + + + + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Occurs when a property value changes. + + + + + Occurs when a property value is changing. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Gets the node type for this . + + The type. + + + + Gets an of this object's properties. + + An of this object's properties. + + + + Gets a the specified name. + + The property name. + A with the specified name or null. + + + + Gets an of this object's property values. + + An of this object's property values. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the with the specified property name. + + + + + + Loads an from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads an from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified property name. + + Name of the property. + The with the specified property name. + + + + Gets the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + One of the enumeration values that specifies how the strings will be compared. + The with the specified property name. + + + + Tries to get the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + The value. + One of the enumeration values that specifies how the strings will be compared. + true if a value was successfully retrieved; otherwise, false. + + + + Adds the specified property name. + + Name of the property. + The value. + + + + Removes the property with the specified name. + + Name of the property. + true if item was successfully removed; otherwise, false. + + + + Tries the get value. + + Name of the property. + The value. + true if a value was successfully retrieved; otherwise, false. + + + + Returns an enumerator that iterates through the collection. + + + A that can be used to iterate through the collection. + + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Returns the properties for this instance of a component. + + + A that represents the properties for this component instance. + + + + + Returns the properties for this instance of a component using the attribute array as a filter. + + An array of type that is used as a filter. + + A that represents the filtered properties for this component instance. + + + + + Returns a collection of custom attributes for this instance of a component. + + + An containing the attributes for this object. + + + + + Returns the class name of this instance of a component. + + + The class name of the object, or null if the class does not have a name. + + + + + Returns the name of this instance of a component. + + + The name of the object, or null if the object does not have a name. + + + + + Returns a type converter for this instance of a component. + + + A that is the converter for this object, or null if there is no for this object. + + + + + Returns the default event for this instance of a component. + + + An that represents the default event for this object, or null if this object does not have events. + + + + + Returns the default property for this instance of a component. + + + A that represents the default property for this object, or null if this object does not have properties. + + + + + Returns an editor of the specified type for this instance of a component. + + A that represents the editor for this object. + + An of the specified type that is the editor for this object, or null if the editor cannot be found. + + + + + Returns the events for this instance of a component using the specified attribute array as a filter. + + An array of type that is used as a filter. + + An that represents the filtered events for this component instance. + + + + + Returns the events for this instance of a component. + + + An that represents the events for this component instance. + + + + + Returns an object that contains the property described by the specified property descriptor. + + A that represents the property whose owner is to be found. + + An that represents the owner of the specified property. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Specifies the settings used when merging JSON. + + + + + Gets or sets the method used when merging JSON arrays. + + The method used when merging JSON arrays. + + + + Gets or sets how how null value properties are merged. + + How null value properties are merged. + + + + Represents a JSON property. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the property name. + + The property name. + + + + Gets or sets the property value. + + The property value. + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Loads an from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads an from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Represents a view of a . + + + + + Initializes a new instance of the class. + + The name. + + + + When overridden in a derived class, returns whether resetting an object changes its value. + + + true if resetting the component changes its value; otherwise, false. + + The component to test for reset capability. + + + + When overridden in a derived class, gets the current value of the property on a component. + + + The value of a property for a given component. + + The component with the property for which to retrieve the value. + + + + + When overridden in a derived class, resets the value for this property of the component to the default value. + + The component with the property value that is to be reset to the default value. + + + + + When overridden in a derived class, sets the value of the component to a different value. + + The component with the property value that is to be set. + The new value. + + + + + When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted. + + + true if the property should be persisted; otherwise, false. + + The component with the property to be examined for persistence. + + + + When overridden in a derived class, gets the type of the component this property is bound to. + + + A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. + + + + + When overridden in a derived class, gets a value indicating whether this property is read-only. + + + true if the property is read-only; otherwise, false. + + + + + When overridden in a derived class, gets the type of the property. + + + A that represents the type of the property. + + + + + Gets the hash code for the name of the member. + + + + The hash code for the name of the member. + + + + + Represents a raw JSON string. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class. + + The raw json. + + + + Creates an instance of with the content of the reader's current token. + + The reader. + An instance of with the content of the reader's current token. + Represents an abstract JSON token. + + + Gets a comparer that can compare two tokens for value equality. + + A that can compare two nodes for value equality. + + + + Gets or sets the parent. + + The parent. + + + + Gets the root of this . + + The root of this . + + + + Gets the node type for this . + + The type. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + Compares the values of two tokens, including the values of all descendant tokens. The first to compare. The second to compare. - true if the tokens are equal; otherwise false. + true if the tokens are equal; otherwise false. + + + + Gets the next sibling token of this node. + + The that contains the next sibling token. + + + + Gets the previous sibling token of this node. + + The that contains the previous sibling token. + + + + Gets the path of the JSON token. + @@ -4256,6 +5421,12 @@ A collection of the sibling tokens before this token, in document order. + + + Gets the with the specified key. + + The with the specified key. + Gets the with the specified key converted to the specified type. @@ -4264,6 +5435,18 @@ The token key. The converted token value. + + + Get the first child token of this token. + + A containing the first child token of the . + + + + Get the last child token of this token. + + A containing the last child token of the . + Returns a collection of the child tokens of this token, in document order. @@ -4884,6 +6067,19 @@ by the token type of the first token encountered in the reader. + + + Creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + An that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + Load a from a string that contains JSON. @@ -4891,6 +6087,28 @@ A that contains JSON. A populated from the string that contains JSON. + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + Creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + An that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + Creates a from a . @@ -5010,1250 +6228,6 @@ The of annotations to remove. - - - Gets a comparer that can compare two tokens for value equality. - - A that can compare two nodes for value equality. - - - - Gets or sets the parent. - - The parent. - - - - Gets the root of this . - - The root of this . - - - - Gets the node type for this . - - The type. - - - - Gets a value indicating whether this token has child tokens. - - - true if this token has child values; otherwise, false. - - - - - Gets the next sibling token of this node. - - The that contains the next sibling token. - - - - Gets the previous sibling token of this node. - - The that contains the previous sibling token. - - - - Gets the path of the JSON token. - - - - - Gets the with the specified key. - - The with the specified key. - - - - Get the first child token of this token. - - A containing the first child token of the . - - - - Get the last child token of this token. - - A containing the last child token of the . - - - - Raises the event. - - The instance containing the event data. - - - - Raises the event. - - The instance containing the event data. - - - - Raises the event. - - The instance containing the event data. - - - - Returns a collection of the child tokens of this token, in document order. - - - An of containing the child tokens of this , in document order. - - - - - Returns a collection of the child values of this token, in document order. - - The type to convert the values to. - - A containing the child values of this , in document order. - - - - - Returns a collection of the descendant tokens for this token in document order. - - An containing the descendant tokens of the . - - - - Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - - An containing this token, and all the descendant tokens of the . - - - - Adds the specified content as children of this . - - The content to be added. - - - - Adds the specified content as the first children of this . - - The content to be added. - - - - Creates an that can be used to add tokens to the . - - An that is ready to have content written to it. - - - - Replaces the children nodes of this token with the specified content. - - The content. - - - - Removes the child nodes from this token. - - - - - Merge the specified content into this . - - The content to be merged. - - - - Merge the specified content into this using . - - The content to be merged. - The used to merge the content. - - - - Occurs when the list changes or an item in the list changes. - - - - - Occurs before an item is added to the collection. - - - - - Occurs when the items list of the collection has changed, or the collection is reset. - - - - - Gets the container's children tokens. - - The container's children tokens. - - - - Gets a value indicating whether this token has child tokens. - - - true if this token has child values; otherwise, false. - - - - - Get the first child token of this token. - - - A containing the first child token of the . - - - - - Get the last child token of this token. - - - A containing the last child token of the . - - - - - Gets the count of child JSON tokens. - - The count of child JSON tokens - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class from another object. - - A object to copy from. - - - - Initializes a new instance of the class with the specified content. - - The contents of the array. - - - - Initializes a new instance of the class with the specified content. - - The contents of the array. - - - - Loads an from a . - - A that will be read for the content of the . - A that contains the JSON that was read from the specified . - - - - Load a from a string that contains JSON. - - A that contains JSON. - A populated from the string that contains JSON. - - - - - - - Creates a from an object. - - The object that will be used to create . - A with the values of the specified object - - - - Creates a from an object. - - The object that will be used to create . - The that will be used to read the object. - A with the values of the specified object - - - - Writes this token to a . - - A into which this method will write. - A collection of which will be used when writing the token. - - - - Determines the index of a specific item in the . - - The object to locate in the . - - The index of if found in the list; otherwise, -1. - - - - - Inserts an item to the at the specified index. - - The zero-based index at which should be inserted. - The object to insert into the . - - is not a valid index in the . - The is read-only. - - - - Removes the item at the specified index. - - The zero-based index of the item to remove. - - is not a valid index in the . - The is read-only. - - - - Returns an enumerator that iterates through the collection. - - - A that can be used to iterate through the collection. - - - - - Adds an item to the . - - The object to add to the . - The is read-only. - - - - Removes all items from the . - - The is read-only. - - - - Determines whether the contains a specific value. - - The object to locate in the . - - true if is found in the ; otherwise, false. - - - - - Copies to. - - The array. - Index of the array. - - - - Removes the first occurrence of a specific object from the . - - The object to remove from the . - - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - - The is read-only. - - - - Gets the container's children tokens. - - The container's children tokens. - - - - Gets the node type for this . - - The type. - - - - Gets the with the specified key. - - The with the specified key. - - - - Gets or sets the at the specified index. - - - - - - Gets a value indicating whether the is read-only. - - true if the is read-only; otherwise, false. - - - - Represents a JSON constructor. - - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class from another object. - - A object to copy from. - - - - Initializes a new instance of the class with the specified name and content. - - The constructor name. - The contents of the constructor. - - - - Initializes a new instance of the class with the specified name and content. - - The constructor name. - The contents of the constructor. - - - - Initializes a new instance of the class with the specified name. - - The constructor name. - - - - Writes this token to a . - - A into which this method will write. - A collection of which will be used when writing the token. - - - - Loads an from a . - - A that will be read for the content of the . - A that contains the JSON that was read from the specified . - - - - Gets the container's children tokens. - - The container's children tokens. - - - - Gets or sets the name of this constructor. - - The constructor name. - - - - Gets the node type for this . - - The type. - - - - Gets the with the specified key. - - The with the specified key. - - - - Represents a collection of objects. - - The type of token - - - - An empty collection of objects. - - - - - Initializes a new instance of the struct. - - The enumerable. - - - - Returns an enumerator that iterates through the collection. - - - A that can be used to iterate through the collection. - - - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - - - Determines whether the specified is equal to this instance. - - The to compare with this instance. - - true if the specified is equal to this instance; otherwise, false. - - - - - Determines whether the specified is equal to this instance. - - The to compare with this instance. - - true if the specified is equal to this instance; otherwise, false. - - - - - Returns a hash code for this instance. - - - A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. - - - - - Gets the with the specified key. - - - - - - Represents a JSON object. - - - - - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class from another object. - - A object to copy from. - - - - Initializes a new instance of the class with the specified content. - - The contents of the object. - - - - Initializes a new instance of the class with the specified content. - - The contents of the object. - - - - Gets an of this object's properties. - - An of this object's properties. - - - - Gets a the specified name. - - The property name. - A with the specified name or null. - - - - Gets an of this object's property values. - - An of this object's property values. - - - - Loads an from a . - - A that will be read for the content of the . - A that contains the JSON that was read from the specified . - - - - Load a from a string that contains JSON. - - A that contains JSON. - A populated from the string that contains JSON. - - - - - - - Creates a from an object. - - The object that will be used to create . - A with the values of the specified object - - - - Creates a from an object. - - The object that will be used to create . - The that will be used to read the object. - A with the values of the specified object - - - - Writes this token to a . - - A into which this method will write. - A collection of which will be used when writing the token. - - - - Gets the with the specified property name. - - Name of the property. - The with the specified property name. - - - - Gets the with the specified property name. - The exact property name will be searched for first and if no matching property is found then - the will be used to match a property. - - Name of the property. - One of the enumeration values that specifies how the strings will be compared. - The with the specified property name. - - - - Tries to get the with the specified property name. - The exact property name will be searched for first and if no matching property is found then - the will be used to match a property. - - Name of the property. - The value. - One of the enumeration values that specifies how the strings will be compared. - true if a value was successfully retrieved; otherwise, false. - - - - Adds the specified property name. - - Name of the property. - The value. - - - - Removes the property with the specified name. - - Name of the property. - true if item was successfully removed; otherwise, false. - - - - Tries the get value. - - Name of the property. - The value. - true if a value was successfully retrieved; otherwise, false. - - - - Returns an enumerator that iterates through the collection. - - - A that can be used to iterate through the collection. - - - - - Raises the event with the provided arguments. - - Name of the property. - - - - Raises the event with the provided arguments. - - Name of the property. - - - - Returns the properties for this instance of a component. - - - A that represents the properties for this component instance. - - - - - Returns the properties for this instance of a component using the attribute array as a filter. - - An array of type that is used as a filter. - - A that represents the filtered properties for this component instance. - - - - - Returns a collection of custom attributes for this instance of a component. - - - An containing the attributes for this object. - - - - - Returns the class name of this instance of a component. - - - The class name of the object, or null if the class does not have a name. - - - - - Returns the name of this instance of a component. - - - The name of the object, or null if the object does not have a name. - - - - - Returns a type converter for this instance of a component. - - - A that is the converter for this object, or null if there is no for this object. - - - - - Returns the default event for this instance of a component. - - - An that represents the default event for this object, or null if this object does not have events. - - - - - Returns the default property for this instance of a component. - - - A that represents the default property for this object, or null if this object does not have properties. - - - - - Returns an editor of the specified type for this instance of a component. - - A that represents the editor for this object. - - An of the specified type that is the editor for this object, or null if the editor cannot be found. - - - - - Returns the events for this instance of a component using the specified attribute array as a filter. - - An array of type that is used as a filter. - - An that represents the filtered events for this component instance. - - - - - Returns the events for this instance of a component. - - - An that represents the events for this component instance. - - - - - Returns an object that contains the property described by the specified property descriptor. - - A that represents the property whose owner is to be found. - - An that represents the owner of the specified property. - - - - - Returns the responsible for binding operations performed on this object. - - The expression tree representation of the runtime value. - - The to bind this object. - - - - - Gets the container's children tokens. - - The container's children tokens. - - - - Occurs when a property value changes. - - - - - Occurs when a property value is changing. - - - - - Gets the node type for this . - - The type. - - - - Gets the with the specified key. - - The with the specified key. - - - - Gets or sets the with the specified property name. - - - - - - Specifies the settings used when merging JSON. - - - - - Gets or sets the method used when merging JSON arrays. - - The method used when merging JSON arrays. - - - - Represents a JSON property. - - - - - Initializes a new instance of the class from another object. - - A object to copy from. - - - - Initializes a new instance of the class. - - The property name. - The property content. - - - - Initializes a new instance of the class. - - The property name. - The property content. - - - - Writes this token to a . - - A into which this method will write. - A collection of which will be used when writing the token. - - - - Loads an from a . - - A that will be read for the content of the . - A that contains the JSON that was read from the specified . - - - - Gets the container's children tokens. - - The container's children tokens. - - - - Gets the property name. - - The property name. - - - - Gets or sets the property value. - - The property value. - - - - Gets the node type for this . - - The type. - - - - Represents a view of a . - - - - - Initializes a new instance of the class. - - The name. - - - - When overridden in a derived class, returns whether resetting an object changes its value. - - - true if resetting the component changes its value; otherwise, false. - - The component to test for reset capability. - - - - - When overridden in a derived class, gets the current value of the property on a component. - - - The value of a property for a given component. - - The component with the property for which to retrieve the value. - - - - - When overridden in a derived class, resets the value for this property of the component to the default value. - - The component with the property value that is to be reset to the default value. - - - - - When overridden in a derived class, sets the value of the component to a different value. - - The component with the property value that is to be set. - The new value. - - - - - When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted. - - - true if the property should be persisted; otherwise, false. - - The component with the property to be examined for persistence. - - - - - When overridden in a derived class, gets the type of the component this property is bound to. - - - A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. - - - - - When overridden in a derived class, gets a value indicating whether this property is read-only. - - - true if the property is read-only; otherwise, false. - - - - - When overridden in a derived class, gets the type of the property. - - - A that represents the type of the property. - - - - - Gets the hash code for the name of the member. - - - - The hash code for the name of the member. - - - - - Represents a raw JSON string. - - - - - Represents a value in JSON (string, integer, date, etc). - - - - - Initializes a new instance of the class from another object. - - A object to copy from. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Initializes a new instance of the class with the given value. - - The value. - - - - Creates a comment with the given value. - - The value. - A comment with the given value. - - - - Creates a string with the given value. - - The value. - A string with the given value. - - - - Creates a null value. - - A null value. - - - - Creates a null value. - - A null value. - - - - Writes this token to a . - - A into which this method will write. - A collection of which will be used when writing the token. - - - - Indicates whether the current object is equal to another object of the same type. - - - true if the current object is equal to the parameter; otherwise, false. - - An object to compare with this object. - - - - Determines whether the specified is equal to the current . - - The to compare with the current . - - true if the specified is equal to the current ; otherwise, false. - - - The parameter is null. - - - - - Serves as a hash function for a particular type. - - - A hash code for the current . - - - - - Returns a that represents this instance. - - - A that represents this instance. - - - - - Returns a that represents this instance. - - The format. - - A that represents this instance. - - - - - Returns a that represents this instance. - - The format provider. - - A that represents this instance. - - - - - Returns a that represents this instance. - - The format. - The format provider. - - A that represents this instance. - - - - - Returns the responsible for binding operations performed on this object. - - The expression tree representation of the runtime value. - - The to bind this object. - - - - - Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object. - - An object to compare with this instance. - - A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings: - Value - Meaning - Less than zero - This instance is less than . - Zero - This instance is equal to . - Greater than zero - This instance is greater than . - - - is not the same type as this instance. - - - - - Gets a value indicating whether this token has child tokens. - - - true if this token has child values; otherwise, false. - - - - - Gets the node type for this . - - The type. - - - - Gets or sets the underlying token value. - - The underlying token value. - - - - Initializes a new instance of the class from another object. - - A object to copy from. - - - - Initializes a new instance of the class. - - The raw json. - - - - Creates an instance of with the content of the reader's current token. - - The reader. - An instance of with the content of the reader's current token. - Compares tokens to determine whether they are equal. @@ -6266,7 +6240,7 @@ The first object of type to compare. The second object of type to compare. - true if the specified objects are equal; otherwise, false. + true if the specified objects are equal; otherwise, false. @@ -6282,63 +6256,25 @@ Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + Gets the at the reader's current position. + + Initializes a new instance of the class. The token to read from. - - - Reads the next JSON token from the stream as a []. - - - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. - - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - Reads the next JSON token from the stream. - true if the next token was read successfully; false if there are no more tokens to read. + true if the next token was read successfully; false if there are no more tokens to read. - - - Gets the at the reader's current position. - - Gets the path of the current JSON token. @@ -6444,6 +6380,17 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Gets the at the writer's current position. + + + + + Gets the token being writen. + + The token being writen. + Initializes a new instance of the class writing to the given . @@ -6642,16 +6589,264 @@ The value to write. - + - Gets the at the writer's current position. + Represents a value in JSON (string, integer, date, etc). - + - Gets the token being writen. + Initializes a new instance of the class from another object. - The token being writen. + A object to copy from. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Creates a comment with the given value. + + The value. + A comment with the given value. + + + + Creates a string with the given value. + + The value. + A string with the given value. + + + + Creates a null value. + + A null value. + + + + Creates a undefined value. + + A undefined value. + + + + Gets the node type for this . + + The type. + + + + Gets or sets the underlying token value. + + The underlying token value. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Indicates whether the current object is equal to another object of the same type. + + + true if the current object is equal to the parameter; otherwise, false. + + An object to compare with this object. + + + + Determines whether the specified is equal to the current . + + The to compare with the current . + + true if the specified is equal to the current ; otherwise, false. + + + The parameter is null. + + + + + Serves as a hash function for a particular type. + + + A hash code for the current . + + + + + Returns a that represents this instance. + + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format provider. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + The format provider. + + A that represents this instance. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object. + + An object to compare with this instance. + + A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings: + Value + Meaning + Less than zero + This instance is less than . + Zero + This instance is equal to . + Greater than zero + This instance is greater than . + + + is not the same type as this instance. + + + + + Specifies the settings used when loading JSON. + + + + + Gets or sets how JSON comments are handled when loading JSON. + + The JSON comment handling. + + + + Gets or sets how JSON line info is handled when loading JSON. + + The JSON line info handling. @@ -6670,6 +6865,21 @@ Merge array items together, matched by index. + + + Specifies how null value properties are merged. + + + + + The content's null value properties will be ignored during merging. + + + + + The content's null value properties will be merged. + + Specifies the member serialization options for the . @@ -6683,7 +6893,7 @@ - Only members must be marked with or are serialized. + Only members marked with or are serialized. This member serialization mode can also be set by marking the class with . @@ -6734,8 +6944,8 @@ Specifies null value handling options for the . - - + + @@ -6774,7 +6984,7 @@ Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. - + @@ -6837,6 +7047,11 @@ The property must be defined in JSON and cannot be a null value. + + + The property is not required but it cannot be a null value. + + @@ -6913,62 +7128,6 @@ - - - Initializes a new instance of the class. - - - - - Reads a from the specified . - - The containing the JSON Schema to read. - The object representing the JSON Schema. - - - - Reads a from the specified . - - The containing the JSON Schema to read. - The to use when resolving schema references. - The object representing the JSON Schema. - - - - Load a from a string that contains schema JSON. - - A that contains JSON. - A populated from the string that contains JSON. - - - - Parses the specified json. - - The json. - The resolver. - A populated from the string that contains JSON. - - - - Writes this schema to a . - - A into which this method will write. - - - - Writes this schema to a using the specified . - - A into which this method will write. - The resolver used. - - - - Returns a that represents the current . - - - A that represents the current . - - Gets or sets the id. @@ -7165,6 +7324,62 @@ The format. + + + Initializes a new instance of the class. + + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The object representing the JSON Schema. + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The to use when resolving schema references. + The object representing the JSON Schema. + + + + Load a from a string that contains schema JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + Parses the specified json. + + The json. + The resolver. + A populated from the string that contains JSON. + + + + Writes this schema to a . + + A into which this method will write. + + + + Writes this schema to a using the specified . + + A into which this method will write. + The resolver used. + + + + Returns a that represents the current . + + + A that represents the current . + + @@ -7175,6 +7390,24 @@ + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + Initializes a new instance of the class. @@ -7204,24 +7437,6 @@ The parameter is null. The class name is null or is zero (0). - - - Gets the line number indicating where the error occurred. - - The line number indicating where the error occurred. - - - - Gets the line position indicating where the error occurred. - - The line position indicating where the error occurred. - - - - Gets the path to the JSON where the error occurred. - - The path to the JSON where the error occurred. - @@ -7232,6 +7447,17 @@ + + + Gets or sets how undefined schemas are handled by the serializer. + + + + + Gets or sets the contract resolver. + + The contract resolver. + Generate a from the specified type. @@ -7264,17 +7490,6 @@ Specify whether the generated root will be nullable. A generated from the specified type. - - - Gets or sets how undefined schemas are handled by the serializer. - - - - - Gets or sets the contract resolver. - - The contract resolver. - @@ -7285,6 +7500,12 @@ + + + Gets or sets the loaded schemas. + + The loaded schemas. + Initializes a new instance of the class. @@ -7297,12 +7518,6 @@ The id. A for the specified reference. - - - Gets or sets the loaded schemas. - - The loaded schemas. - @@ -7421,31 +7636,123 @@ + + + A snake case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + A camel case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + Resolves member mappings for a type, camel casing property names. + + + Initializes a new instance of the class. + + Used by to resolves a for a given . - + - Used by to resolves a for a given . + Gets a value indicating whether members are being get and set using dynamic code generation. + This value is determined by the runtime permissions available. - - - - + + true if using dynamic code generation; otherwise, false. + - + - Resolves the contract for a given type. + Gets or sets the default members search flags. - The type to resolve a contract for. - The contract for a given type. + The default members search flags. + + + + Gets or sets a value indicating whether compiler generated members should be serialized. + + + true if serialized compiler generated members; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the interface when serializing and deserializing types. + + + true if the interface will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the attribute when serializing and deserializing types. + + + true if the attribute will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets the naming strategy used to resolve how property names and dictionary keys are serialized. + + The naming strategy used to resolve how property names and dictionary keys are serialized. @@ -7502,10 +7809,10 @@ - Resolves the default for the contract. + Resolves the default for the contract. Type of the object. - The contract's default . + The contract's default . @@ -7607,95 +7914,17 @@ Name of the property. Name of the property. - + - Gets a value indicating whether members are being get and set using dynamic code generation. - This value is determined by the runtime permissions available. - - - true if using dynamic code generation; otherwise, false. - - - - - Gets or sets the default members search flags. - - The default members search flags. - - - - Gets or sets a value indicating whether compiler generated members should be serialized. - - - true if serialized compiler generated members; otherwise, false. - - - - - Gets or sets a value indicating whether to ignore the interface when serializing and deserializing types. - - - true if the interface will be ignored when serializing and deserializing types; otherwise, false. - - - - - Gets or sets a value indicating whether to ignore the attribute when serializing and deserializing types. - - - true if the attribute will be ignored when serializing and deserializing types; otherwise, false. - - - - - Initializes a new instance of the class. + The default naming strategy. Property names and dictionary keys are unchanged. - + - Resolves the name of the property. + Resolves the specified property name. - Name of the property. - The property name camel cased. - - - - Used to resolve references when serializing and deserializing JSON by the . - - - - - Resolves a reference to its object. - - The serialization context. - The reference to resolve. - The object that - - - - Gets the reference for the sepecified object. - - The serialization context. - The object to get a reference for. - The reference to the object. - - - - Determines whether the specified object is referenced. - - The serialization context. - The object to test for a reference. - - true if the specified object is referenced; otherwise, false. - - - - - Adds a reference to the specified object. - - The serialization context. - The reference. - The object to reference. + The property name to resolve. + The resolved property name. @@ -7725,35 +7954,6 @@ Represents a trace writer that writes to the application's instances. - - - Represents a trace writer. - - - - - Writes the specified trace level, message and optional exception. - - The at which to write this trace. - The trace message. - The trace exception. This parameter is optional. - - - - Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. - - The that will be used to filter the trace messages passed to the writer. - - - - Writes the specified trace level, message and optional exception. - - The at which to write this trace. - The trace message. - The trace exception. This parameter is optional. - Gets the that will be used to filter the trace messages passed to the writer. @@ -7764,30 +7964,19 @@ The that will be used to filter the trace messages passed to the writer. + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + Get and set values for a using dynamic methods. - - - Provides methods to get and set values. - - - - - Sets the value. - - The target to set the value on. - The value to set on the target. - - - - Gets the value. - - The target to get the value from. - The value. - Initializes a new instance of the class. @@ -7848,13 +8037,6 @@ Provides data for the Error event. - - - Initializes a new instance of the class. - - The current object. - The error context. - Gets the current object the error event is being raised against. @@ -7867,6 +8049,13 @@ The error context. + + + Initializes a new instance of the class. + + The current object. + The error context. + Get and set values for a using dynamic methods. @@ -7912,16 +8101,240 @@ When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. + + + Used by to resolves a for a given . + + + + + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + A base class for resolving how property names and dictionary keys are serialized. + + + + + A flag indicating whether dictionary keys should be processed. + Defaults to false. + + + + + A flag indicating whether explicitly specified property names, + e.g. a property name customized with a , should be processed. + Defaults to false. + + + + + Gets the serialized name for a given property name. + + The initial property name. + A flag indicating whether the property has had a name explicitly specfied. + The serialized property name. + + + + Gets the serialized key for a given dictionary key. + + The initial dictionary key. + The serialized dictionary key. + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Used to resolve references when serializing and deserializing JSON by the . + + + + + Resolves a reference to its object. + + The serialization context. + The reference to resolve. + The object that + + + + Gets the reference for the sepecified object. + + The serialization context. + The object to get a reference for. + The reference to the object. + + + + Determines whether the specified object is referenced. + + The serialization context. + The object to test for a reference. + + true if the specified object is referenced; otherwise, false. + + + + + Adds a reference to the specified object. + + The serialization context. + The reference. + The object to reference. + + + + Represents a trace writer. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of Info will exclude Verbose messages and include Info, + Warning and Error messages. + + The that will be used to filter the trace messages passed to the writer. + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Provides methods to get and set values. + + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + Contract details for a used by the . + + + Gets the of the collection items. + + The of the collection items. + + + + Gets a value indicating whether the collection type is a multidimensional array. + + true if the collection type is a multidimensional array; otherwise, false. + + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the collection values. + + true if the creator has a parameter with the collection values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + Contract details for a used by the . + + + Gets or sets the default collection items . + + The converter. + + + + Gets or sets a value indicating whether the collection items preserve object references. + + true if collection items preserve object references; otherwise, false. + + + + Gets or sets the collection item reference loop handling. + + The reference loop handling. + + + + Gets or sets the collection item type name handling. + + The type name handling. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Handles serialization callback events. + + The object that raised the callback event. + The streaming context. + + + + Handles serialization error callback events. + + The object that raised the callback event. + The streaming context. + The error context. + + + + Sets extension data for an object during deserialization. + + The object to set extension data on. + The extension data key. + The extension data value. + + + + Gets extension data for an object during serialization. + + The object to set extension data on. + Contract details for a used by the . @@ -7947,7 +8360,7 @@ - Gets or sets the default for this contract. + Gets or sets the default for this contract. The converter. @@ -8023,94 +8436,11 @@ true if the default object creator is non-public; otherwise, false. - - - Initializes a new instance of the class. - - The underlying type for the contract. - - - - Gets or sets the default collection items . - - The converter. - - - - Gets or sets a value indicating whether the collection items preserve object references. - - true if collection items preserve object references; otherwise, false. - - - - Gets or sets the collection item reference loop handling. - - The reference loop handling. - - - - Gets or sets the collection item type name handling. - - The type name handling. - - - - Initializes a new instance of the class. - - The underlying type for the contract. - - - - Gets the of the collection items. - - The of the collection items. - - - - Gets a value indicating whether the collection type is a multidimensional array. - - true if the collection type is a multidimensional array; otherwise, false. - - - - Handles serialization callback events. - - The object that raised the callback event. - The streaming context. - - - - Handles serialization error callback events. - - The object that raised the callback event. - The streaming context. - The error context. - - - - Sets extension data for an object during deserialization. - - The object to set extension data on. - The extension data key. - The extension data value. - - - - Gets extension data for an object during serialization. - - The object to set extension data on. - Contract details for a used by the . - - - Initializes a new instance of the class. - - The underlying type for the contract. - Gets or sets the property name resolver. @@ -8135,17 +8465,29 @@ The of the dictionary values. + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the dictionary values. + + true if the creator has a parameter with the dictionary values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + Contract details for a used by the . - - - Initializes a new instance of the class. - - The underlying type for the contract. - Gets the object's properties. @@ -8158,23 +8500,29 @@ The property name resolver. + + + Initializes a new instance of the class. + + The underlying type for the contract. + Contract details for a used by the . - - - Initializes a new instance of the class. - - The underlying type for the contract. - Gets or sets the ISerializable object constructor. The ISerializable object constructor. + + + Initializes a new instance of the class. + + The underlying type for the contract. + Contract details for a used by the . @@ -8191,12 +8539,6 @@ Contract details for a used by the . - - - Initializes a new instance of the class. - - The underlying type for the contract. - Gets or sets the object member serialization. @@ -8258,6 +8600,17 @@ Gets or sets the extension data getter. + + + Gets or sets the extension data value type. + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + Contract details for a used by the . @@ -8274,14 +8627,6 @@ Maps a JSON property to a .NET member or constructor parameter. - - - Returns a that represents this instance. - - - A that represents this instance. - - Gets or sets the name of the property. @@ -8296,9 +8641,9 @@ - Gets or sets the order of serialization and deserialization of a member. + Gets or sets the order of serialization of a member. - The numeric order of serialization or deserialization. + The numeric order of serialization. @@ -8326,7 +8671,7 @@ - Gets or sets the for the property. + Gets or sets the for the property. If set this converter takes presidence over the contract converter for the property type. The converter. @@ -8417,6 +8762,12 @@ A predicate used to determine whether the property should be serialize. + + + Gets or sets a predicate used to determine whether the property should be deserialized. + + A predicate used to determine whether the property should be deserialized. + Gets or sets a predicate used to determine whether the property should be serialized. @@ -8429,6 +8780,14 @@ An action used to set whether the property has been deserialized. + + + Returns a that represents this instance. + + + A that represents this instance. + + Gets or sets the converter used when serializing the property's collection items. @@ -8513,19 +8872,22 @@ Optional arguments to pass to an initializing constructor of the JsonConverter. If null, the default constructor is used. - - - Create a factory function that can be used to create instances of a JsonConverter described by the - argument type. The returned function can then be used to either invoke the converter's default ctor, or any - parameterized constructors by way of an object array. - - Represents a trace writer that writes to memory. When the trace message limit is reached then old trace messages will be removed as new messages are added. + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of Info will exclude Verbose messages and include Info, + Warning and Error messages. + + + The that will be used to filter the trace messages passed to the writer. + + Initializes a new instance of the class. @@ -8553,16 +8915,6 @@ A of the most recent trace messages. - - - Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. - - - The that will be used to filter the trace messages passed to the writer. - - Represents a method that constructs an object. @@ -8649,6 +9001,11 @@ Specifies type name handling options for the . + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than TypeNameHandling.None. + @@ -8691,16 +9048,6 @@ The list to add to. The collection of elements to add. - - - Returns the index of the first occurrence in a sequence by using a specified IEqualityComparer{TSource}. - - The type of the elements of source. - A sequence in which to locate a value. - The object to locate in the sequence - An equality comparer to compare values. - The zero-based index of the first occurrence of value within the entire sequence, if found; otherwise, –1. - Converts the value to the specified type. If the value is unable to be converted, the @@ -8836,13 +9183,6 @@ true if the string is all white space; otherwise, false. - - - Nulls an empty string. - - The string. - Null if the string was null, otherwise the string unchanged. - Specifies the state of the . diff --git a/CMS_SC/bin/it/Microsoft.Build.Utilities.v3.5.resources.dll b/CMS_SC/bin/it/Microsoft.Build.Utilities.v3.5.resources.dll new file mode 100644 index 0000000..a7861a9 Binary files /dev/null and b/CMS_SC/bin/it/Microsoft.Build.Utilities.v3.5.resources.dll differ