Marqdouj.CLRCommon 8.10.1

CLRCommon

CLRCommon is a collection of helper utilities and classes for .NET development.

NuGet Package

The NuGet package can be found here

Demo

• A demo of this and some of my other NuGet packages can be found here

Features

• Enum
  • EnumList. Manages a list of Enum (no duplicates)
• ExceptionExtensions
  • ToMessage(). Resolves all messages recursively. Returns a joined string (optional separator).
  • ToList(). Resolves all messages recursively. Returns a list of messages.
• FloatingPointExtensions
  • ToStringFormat(). Converts a float, double, or decimal to a string with the option to truncate the decimal places if the value is a whole number (i.e. 1.00 becomes 1).
• ListExtensions
  • ToDataTable(). Converts a list of objects to a System.Data.DataTable.
• ObjectExtensions
  • IsNumber(). Checks if the underlying type code is a number.
• MinMaxN
  • INumber that is constrained between a minimum and maximum value.
  • Provides a StringValue property to convert strings to/from the underlying INumber
• Paging
  • PagedData - a class to hold the results for paged data
  • PagedRange - a class to calculate a range of pages
  • PageInfo - a class to hold paging information
• PathExtensions
  • Helper method to resolve a folder locations not supported by Environment.GetFolderPath
    • Currently only the Downloads folder is supported
• StateContainer
  • Notifcations when a value changes (StateChanged).
  • Supports INotifyPropertyChanged and Action (Blazor)
• StringExtensions
  • IsNumeric - determines if a string is numeric
  • IsPositiveInteger - determines if a string is a positive integer
  • Left - returns the leftmost characters of a string (Mimics VB's Left function))
  • Right - returns the rightmost characters of a string (Mimics VB's Right function))
  • ToBoolOrNull - converts a string to a Boolean or null (supports Y/N, YES/NO, 1/-1))
  • ToCrLf - Takes a string and converts its line endings to CrLf
  • ToDecimal - converts a string to a decimal
  • ToDecimalOrNull - converts a string to a decimal or null
  • ToDecimalOrValue - converts a string to a decimal or a specified default value
  • ToDouble - converts a string to a double
  • ToDoubleOrNull - converts a string to a double or null
  • ToDoubleOrValue - converts a string to a double or a specified default value
  • ToInt32 - converts a string to an integer
  • ToInt32OrNull - converts a string to an integer or null
  • ToInt32OrValue - converts a string to an integer or a specified default value
  • ToInt32List - converts a delimited string to a list of integers
  • ToInt64 - converts a string to a long
  • ToInt64OrNull - converts a string to a long or null
  • ToInt64OrValue - converts a string to a long or a specified default value
  • ToInt64List - converts a delimited string to a list of longs
  • ToNewLine - Converts line endings to Environment.NewLine
  • ToTitleCase - converts a string to title case using a specified culture (wrapper for TextInfo.ToTitleCase))
  • Truncate - truncates a string to a specified length
• StringExtensions (Lists)
  • ToInt32List - Converts delimited string of integer to Int32 List
  • ToInt64List - Converts delimited string of long to Int64 List

Release Notes

v8.10.1

• ObjectExtensions.IsNumber(). Enhanced with INumber<T>.IsAssignableFrom

v8.10.0

• StateContainer.
  • Added the SetValueB virtual method. Returns true if the value was changed.
  • Changed SetValue to a virtual method.
  • Added the static ValueWillChange method; a pre-check that the value will be changed by the SetValue method. May be used for custom scenarios where logic needs to know if the value would have been changed but the SetValue method will not be invoked.

v8.9.3

• StateContainer. Added the CallerMemberName attribute to invoke both NotifyStateChanged and NotifyPropertyChanged events. This negates the need to supply a property name when manually invoking the methods in a property set. This also allows to provide a different name if required.

v8.9.2

• StateContainer. Added the NotifyChanged method to invoke both NotifyStateChanged and NotifyPropertyChanged events.

v8.9.1

• MinMaxN.StringValue. Store the constuctor initial value as the default value to be used if the value assigned to StringValue can't be converted to the underlying INumber

v8.9.0

• added MinMaxN.StringValue. Normally used for html text input components that support numbers, i.e. FluentTextField

v8.8.8

• added ObjectExtensions.IsNumber()

v8.8.7

• added FloatingPointToStringFormatOptions to FloatingPointExtensions.ToStringFormat()

v8.8.6

• added Floating Point (decimal, double, float) ToStringFormat() extension method.

v8.8.5

• added EnumList.ToNames() method. Returns an ordered list of item names.

v8.8.4

• added EnumList
• added null check before adding column in ToDataTable

v8.8.3

• added optional separator to Exception.ToMessage() extension.

v8.8.2

• override MinMaxN ToString to return the Value

v8.8.1

• added 'SuppressNotifications' flag to StateContainer

v8.8.0

• Added [JsonConstructor] to MinMaxN

v8.7.1

• Added NuGet pkg icon

v8.7.0

• Fixed bug in MinMaxN calculations for Center/Width properties

v8.6.0 (Depreciated)

• added Center/Width properties to MinMaxN

v8.5.0

• MinMaxN
  • added MinMaxN tests to project
  • added constructor without Value parameter
• added StringExtensions.IsNumeric tests to project
  • added support for null strings in StringExtensions.IsNumeric
• added StringExtensions.IsPositiveInteger tests to project
  • added support for null strings in StringExtensions.IsPositiveInteger
  • Zero is now considered a positive integer in StringExtensions.IsPositiveInteger

v8.4.0

• added StringExtensions tests to project
• found and fixed bug in StringExtensions.ToNewLine

v8.3.0

• refactored StringExtensions.Truncate.

v8.2.1

• removed 'AllowUnsafeBlocks' from project file (not needed)
• added StringExtension Method
  • String.ToNewLine - Converts line endings to Environment.NewLine

v8.2.0

• Updated Comments
• added ListExtensions / IEnumerableExtensions
  • ToDataTable - converts a list of objects to a DataTable
• added PathExtensions
  • GetPath - returns the path of a known folder not supported by Environment.SpecialFolder
    • currently only supports Downloads folder
• added StringExtensions
• added Paging helper class

v8.1.1

• added MinMaxN<T> / INumber<T>: ensures a value is within a min/max range
• added ExceptionExtensions
  • ToMessage - returns the message of an exception and all inner exceptions
  • ToMessages - returns the message of an exception and all inner exceptions as a list

v8.1.0

• BREAKING CHANGES.
• StateContainer: Changed OnChange to StateChanged; added INotifyPropertyChanged support/PropertyChanged