Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.2.0-alpha002

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.2.0-alpha003

Changelog

This release adds a bit of new funtionality, but mainly focuses on porting new functionality from the v1.1.x package.

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.68

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.68

Changelog

• Marked misc classes as obsolete (see feda4ca)
  The classes have had alternatives within the package for years, and should already have been marked as obsolete. The classes will be removed in v1.2 (or v2.0, if v1.2 becomes v2.0).

• Copied extension method classes in individual namespaces (see ea7d575)
  Having the extension in the same namespace are more likely to cause conflicts (ambigious references) with other packages, so similar extension methods are now available in individual namespaces. The existing extension methods has been marked as obsolete.

• Added misc IsMatch extension methods overloads for .NET's Regex class (see 320f179)
  These extension adds similar functionality to the existing RegexUtils.IsMatch utility methods.

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.2.0-alpha002

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.2.0-alpha002

Changelog

This release adds a bit of new funtionality, but mainly focuses on porting new functionality from the v1.1.x package.

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.67

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.67

Changelog

• Added static methods to the PropertyNotException class to allow guard-style pattern (see 31bfe38)
  Added ThrowIfNull, ThrowIfNullOrEmpty and ThrowIfNullOrWhiteSpace static methods to the PropertyNotException class.

• Copied the SetExtensions class to a new namespace (see 2ba0e60)
  The new namespace is less likely to cause namespace collisions. The old SetExtensions class still exists, but is now marked as obsolete. it will be removed in a future version.

• Added new EnumerableUtils, ListUtils and SetUtils static utility classes (see d5d1a46)
  The new classes support misc operations specific for the intended return type.

• Copied ListExtensions class to new namespace (see 2b45855)
  The new namespace is less likely to cause namespace collisions. The old ListExtensions class still exists, but is now marked as obsolete. it will be removed in a future version.

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.66

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.66

Changelog

• Fixed bad method names (see 71726b7)
  Technically this is a breaking change, but only in releation to v1.1.65, which was released just this morning.

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.65

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.65

Changelog

• Introduced new AddRange extension method for for ISet<T> (see daa1ad4)

• Added ReadAsString and ReadAsStringAsync extension methods for reading the contents of a stream into a string (see 7ceadec)

• Added additional ToEssentialsDate and ToEssentialsTime extension methods (see 5bea9be)
  Since both DateTime and DateTimeOffset are structs, the existing extension methods for DateTime? and DateTimeOffset? can't be used with DateTime and DateTimeOffset, so new extension methods to target these have been added.

• Added misc extension methods for deconstructing instances of IReadOnlyList<T> (see a23a066)

• Added misc extension methods for HttpClient and related classes (see e8b7d9f)

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.64

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.64

Changelog

• Added Then extension methods for use in async method chains (see 389deeb)

• Added ToStringList extension methods for string (see 678ce14)

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.63

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.63

Changelog

• Added misc utility and extension methods for converting string values into corresponding HashSet<> values (see 22cbf8b)
  Similar to the existing StringUtils.Parse{Type}Array and StringUtils.Parse{Type}List, similar StringUtils.Parse{Type}Set methods are now available with this release.

• Added .NET 8 and .NET 10 as additional target frameworks (see 22da437)
  These are LTS releases of .NET and as such should be the primary target frameworks for this package. Ideally all EOL target frameworks should be removed, but as this would be a breaking change, this will be addressed in a v1.2.0 or 2.0.0 release instead.

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.62

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.62

Changelog

• Fixed issue with EssentialsTime.FromTicks (see 109a493)
  Two of the method overloads would internally parse the ticks into a DateTime instance, but not specify a Kind, in which case this falls back to Unspecified, thereby creating a lot of uncertainty when converting back and forth between time zones. With this commit, the two method overloads will instead use parse the ticks into a DateTimeOffset relative to UTC, and then convert to the time zone specified by the user.

Installation

Install via NuGet - either via the .NET CLI:

dotnet add package Skybrud.Essentials --version 1.1.61

or the NuGet Package Manager:

Install-Package Skybrud.Essentials -Version 1.1.61

Changelog

• Fixed issue with ToInvariantString extension methods (see a01b5f1)
  For the overloading taking an IFormattable, we shouldn't use string.Format as the format is directly for the IFormattable.

• Fixed misc issues when getting values from JArray (see 63c9245)
  The idea behind these methods is that they should to call, meaning if you call GetInt32(0) and the item isn't found, or the value cannot be converted to a 32-bit integer, the method should return a default value instead of throwing an exception. As this wasn't the case, the implementation has been updated to reflect this.

  • added check for min and max values
  • no longer tries to cast values
  • added additional GetType and TryGetType extension methods
  • added lots of unit tests
  • etc.