Skip to content

PACKAGE_README.md

Latest commit

 

History

History
155 lines (134 loc) · 4.99 KB

PACKAGE_README.md

File metadata and controls

155 lines (134 loc) · 4.99 KB
Raw

Egonsoft.HU BCL Extensions

C# extension methods for Base Class Library types.

Summary

  • Extension methods for throwing ArgumentNullException
  • Extension methods for throwing ArgumentException
  • Extension methods for throwing ArgumentOutOfRangeException
  • Extension methods for specific types
  • Extension methods with generic type parameters
  • Predefined (const / readonly) values
  • More information

Extension methods for throwing ArgumentNullException or ArgumentException

  • For generic T type:
    • ThrowIfNull<T>() throws ArgumentNullException
  • For System.String type:
    • ThrowIfNullOrEmpty() throws ArgumentNullException or ArgumentException
    • ThrowIfNullOrWhiteSpace() throws ArgumentNullException or ArgumentException
  • For System.Guid type:
    • ThrowIfEmptyGuid() throws ArgumentException

Extension methods for throwing ArgumentOutOfRangeException

Would you like to use the new static methods in ArgumentOutOfRangeException that were introduced in .NET 8 but your project targets an older framework? In this package they are available as extension methods.

  • For IEquatable<T> type:
    • ThrowIfEqualTo()
    • ThrowIfNotEqualTo()
  • For IComparable<T> type:
    • ThrowIfLessThan()
    • ThrowIfLessThanOrEqualTo()
    • ThrowIfGreaterThan
    • ThrowIfGreaterThanOrEqualTo()
  • For numeric types:
    System.SByte, System.Int16, System.Int32, System.Int64,
    System.Byte, System.UInt16, System.UInt32, System.UInt64,
    System.Half, System.Single, System.Double, System.Decimal
    • ThrowIfZero()
    • ThrowIfNegative()
    • ThrowIfNegativeOrZero()
    • ThrowIfPositive()
    • ThrowIfPositiveOrZero()

Extension methods for specific types

This package contains extension methods for these types:

  • System.Collections.Generic.ICollection<T>
    • AddRange()
  • System.Collections.Generic.IDictionary<TKey, TValue>
    • AsReadOnly()
    • AsSorted()
    • DefaultIfKeyNotFound()
    • GetOrThrow()
  • System.Collections.Generic.IEnumerable<T>
    • IsNullOrEmpty()
    • DetectChanges() - Get new, existing and removed items.
  • System.Collections.Generic.IList<T>
    • AsReadOnly() up to .NET 6 (An extension method with the same signature is part of .NET 7+.)
  • System.DateOnly
    • IsInRange()
  • System.DateTime
    • IsInRange()
    • ToMinutePrecision()
    • ToSecondPrecision()
  • System.DateTimeOffset
    • IsInRange()
    • ToMinutePrecision()
    • ToSecondPrecision()
  • System.Exception
    • GetHttpStatusCode()
    • SetHttpStatusCode()
  • System.IO.Stream
    • ToByteArray()
    • ToByteArrayAsync()
    • TryResetStreamPosition()
  • System.Reflection.Assembly
  • System.Reflection.MemberInfo
  • System.Reflection.ParameterInfo
  • System.String
    • IsNullOrEmpty()
    • IsNullOrWhiteSpace()
    • DefaultIfNullOrEmpty()
    • DefaultIfNullOrWhiteSpace()
    • EnsureTrailingSlash()
    • EnsureNoTrailingSlash()
  • System.Type
    • AsNullableValueType()
    • IsNullableValueType()
  • Numeric types:
    System.SByte, System.Int16, System.Int32, System.Int64,
    System.Byte, System.UInt16, System.UInt32, System.UInt64,
    System.Half, System.Single, System.Double, System.Decimal
    • IsZero()
    • IsNegative()
    • IsNegativeOrZero()
    • IsPositive()
    • IsPositiveOrZero()
    • IsInRange()

Extension methods with generic type parameters

  • IEnumerable-related
    • AsSingleElementSequence()
    • IsIn()
    • IsNotIn()
  • Reflection-related
    • GetPropertyValue()
    • TryPropertyValue()
    • SetPropertyValue()
    • TrySetPropertyValue()
  • value selectors
    • GetStringValueOrNull()
    • GetStringValueOrEmptyString()
    • GetValueOrDefault()
    • GetValue()

Predefined (const / readonly) values

  • Chars
  • DateTimeFormats
  • GenericTypeDefinitions
  • GuidFormats
  • HttpStatusCodes
  • Strings

enum types

  • IntervalBoundsOptions - can be used in the new IsInRange() extension methods.

Other types

  • EnumInfo<TEnum>
    • A wrapper class that provides additional information about an enum type or value.
      • The custom attributes applied to a member.
      • Easy access to the list of the defined members.
      • Easy access to the name or the underlying value of a member.
      • Support for customizing the serialized value through attributes.
      • Implements bitwise / comparison / implicit conversion / equality operators.
  • EncodingProvider
    • UTF8WithoutBOM The UTF-8 encoding without the Unicode byte order mark.
  • StringSyntaxAttribute
    • up to .NET 6 (This attribute is part of .NET 7+.)
  • StructuralEqualityComparer<T>
    • Provides a generic IEqualityComparer<T> instance for using the non-generic System.Collections.StructuralComparisons.StructuralEqualityComparer.
  • TypeHelper
    • GetName<T>() / GetName(Type) methods as a shortcut for Type.FullName ?? Type.Name expression.

More information

Learn more at https://github.com/gcsizmadia/EgonsoftHU.Extensions.Bcl