FrameworkExtensions.Backports 1.0.0.156

FrameworkExtensions.Backports

Overview

FrameworkExtensions.Backports is a NuGet package that provides a collection of extensions (Polyfills) to ensure that newer compiler features work in older versions of the .NET Framework/Standard/Core. This package allows developers to use modern C# language features and .NET APIs even when working on projects targeting earlier versions down to Net2.0.

Note: Performance is not a primary concern here. This focuses mainly on functionality and ready-to-be-built without making adjustments to code.

Features

Interfaces

• System

  • IGrouping<out TKey, TElement>
  • IParsable
  • ISpanFormattable
  • ISpanParsable

• System.Collections

  • IStructuralComparable
  • IStructuralEquatable

• System.Collections.Generic

  • IReadOnlyDictionary<TKey, TValue>

• System.Runtime.CompilerServices

  • IAsyncStateMachine
  • ICriticalNotifyCompletion
  • INotifyCompletion
  • ITuple

Types

• System

  • Index
  • Lazy<T>
  • MathF
  • Range
  • ReadOnlySpan<T>
  • Span<T>
  • Tuple<T> (up to 8 types)
  • ValueTuple<T> (up to 8 types)

• System.Buffers

  • ArrayPool<T>

• System.Collections.Concurrent

  • ConcurrentBag<T>
  • ConcurrentDictionary<TKey, TValue>
  • ConcurrentQueue<T>
  • ConcurrentStack<T>

• System.Collections.Generic

  • HashSet<T>
  • ReadOnlyDictionary<TKey, TValue>

• System.Numerics

  • BitOperations

• System.Runtime.CompilerServices

  • AsyncTaskMethodBuilder<T>
  • ConfiguredTaskAwaitable<T>
  • IsExternalInit
  • TaskAwaiter<T>
  • Unsafe

• System.Runtime.InteropServices

  • MemoryMarshal

• System.Runtime.Intrinsics

  • Vector64
  • Vector64<T>
  • Vector128
  • Vector128<T>
  • Vector256
  • Vector256<T>
  • Vector512
  • Vector512<T>

• System.Runtime.Intrinsics.Arm

  • AdvSimd

• System.Runtime.Intrinsics.X86

  • Avx
  • Avx2
  • Avx512F
  • Sse
  • Sse2
  • Sse3
  • Sse41
  • Sse42
  • Ssse3

• System.Threading

  • ManualResetEventSlim

Attributes

• System.Diagnostics

  • StackTraceHidden

• System.Diagnostics.CodeAnalysis

  • DisallowNull
  • DoesNotReturn
  • NotNull
  • NotNullWhen

• System.Runtime.CompilerServices

  • CallerArgumentExpression
  • CallerFilePath
  • CallerLineNumber
  • CallerMemberName
  • Extension
  • TupleElementNames

Delegates

• System
  • Func<T> (up to 16 types)
  • Action<T> (up to 16 types)

Methods

• System.Array

  • Span<T> AsSpan<T>(this T[] @this)
  • Span<T> AsSpan<T>(this T[] @this, int start)
  • Span<T> AsSpan<T>(this T[] @this, int start, int length)
  • Span<T> AsSpan<T>(this T[] @this, Index startIndex)
  • Span<T> AsSpan<T>(this T[] @this, Range range)

• System.ReadOnlySpan

  • bool SequenceEqual<T>(this Span<T> span, ReadOnlySpan<T> other)
  • bool SequenceEqual<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> other)
  • bool SequenceEqual<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> other, IEqualityComparer<T> comparer)
  • int IndexOf<T>(this ReadOnlySpan<T> span, T value)
  • int IndexOf<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> value)
  • int IndexOf(this ReadOnlySpan<char> span, ReadOnlySpan<char> value, StringComparison comparisonType)
  • int LastIndexOf<T>(this ReadOnlySpan<T> span, T value)
  • int LastIndexOf<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> value)
  • int LastIndexOf(this ReadOnlySpan<char> span, ReadOnlySpan<char> value, StringComparison comparisonType)
  • bool StartsWith(this ReadOnlySpan<char> span, ReadOnlySpan<char> value, StringComparison comparisonType)
  • bool StartsWith<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> value)
  • bool StartsWith<T>(this Span<T> span, ReadOnlySpan<T> value)

• System.Collections.Concurrent.ConcurrentBag

  • void Clear<T>(this ConcurrentBag<T>)

• System.Collections.Concurrent.ConcurrentDictionary

  • TValue AddOrUpdate<TKey, TValue, TArg>(this ConcurrentDictionary<TKey, TValue> @this, TKey key, Func<TKey, TArg, TValue> addValueFactory, Func<TKey, TValue, TArg, TValue> updateValueFactory, TArg factoryArgument)

• System.Collections.Concurrent.ConcurrentQueue

  • void Clear<T>(this ConcurrentQueue<T>)

• System.Collections.Concurrent.ConcurrentStack

  • void Clear<T>(this ConcurrentStack<T>)

• System.Collections.Generic.IEnumerable

  • HashSet<TItem> ToHashSet<TItem>(this IEnumerable<TItem> @this)
  • HashSet<TItem> ToHashSet<TItem>(this IEnumerable<TItem> @this, IEqualityComparer<TItem> comparer)

• System.Collections.Generic.KeyValuePair

  • void Deconstruct<TKey, TValue>(this KeyValuePair<TKey, TValue> @this, out TKey key, out TValue value)

• System.Collections.Generic.Stack

  • bool TryPop<TItem>(this Stack<TItem> @this, out TItem result)
  • bool TryPeek<TItem>(this Stack<TItem> @this, out TItem result)

• System.DateTimeOffset

  • long ToUnixTimeMilliseconds(this DateTimeOffset @this)
  • long ToUnixTimeSeconds(this DateTimeOffset @this)

• System.Diagnostics

  • void Restart(this Stopwatch @this)

• System.Enum

  • bool HasFlag<T>(this T @this, T flag)

• System.IO.DirectoryInfo

  • IEnumerable<FileSystemInfo> EnumerateFileSystemInfos(this DirectoryInfo @this)
  • IEnumerable<FileInfo> EnumerateFiles(this DirectoryInfo @this)
  • IEnumerable<DirectoryInfo> EnumerateDirectories(this DirectoryInfo @this)
  • IEnumerable<FileInfo> EnumerateFiles(this DirectoryInfo @this, string searchPattern, SearchOption searchOption)
  • IEnumerable<DirectoryInfo> EnumerateDirectories(this DirectoryInfo @this, string searchPattern, SearchOption searchOption)

• System.IO.FileInfo

  • void MoveTo(this FileInfo @this, string destFileName, bool overwrite)

• System.IO.Stream

  • void CopyTo(this Stream @this, Stream target)
  • void Flush(this Stream @this, bool flushToDisk)
  • Task<int> ReadAsync(this Stream @this, byte[] buffer, int offset, int count)
  • Task<int> ReadAsync(this Stream @this, byte[] buffer, int offset, int count, CancellationToken cancellationToken)
  • Task WriteAsync(this Stream @this, byte[] buffer, int offset, int count)
  • Task WriteAsync(this Stream @this, byte[] buffer, int offset, int count, CancellationToken cancellationToken)
  • Task CopyToAsync(this Stream @this, Stream destination, int bufferSize, CancellationToken cancellationToken)
  • int Read(this Stream @this, Span<byte> buffer)
  • void Write(this Stream @this, ReadOnlySpan<byte> buffer)

• System.Linq

  • TResult[] ToArray<TResult>(this IEnumerable<TResult> @this)
  • IEnumerable<TResult> Cast<TResult>(this IEnumerable @this)
  • IEnumerable<TSource> Where<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate)
  • IEnumerable<TSource> Where<TSource>(this IEnumerable<TSource> @this, Func<TSource, int, bool> predicate)
  • IEnumerable<TResult> Select<TSource, TResult>(this IEnumerable<TSource> @this, Func<TSource, TResult> selector)
  • IEnumerable<TResult> Select<TSource, TResult>(this IEnumerable<TSource> @this, Func<TSource, int, TResult> selector)
  • IEnumerable<TSource> OrderBy<TSource, TKey>(this IEnumerable<TSource> @this, Func<TSource, TKey> keySelector)
  • IEnumerable<TSource> OrderBy<TSource, TKey>(this IEnumerable<TSource> @this, Func<TSource, TKey> keySelector, IComparer<TKey> comparer)
  • IEnumerable<TSource> ThenBy<TSource, TKey>(this IEnumerable<TSource> @this, Func<TSource, TKey> keySelector)
  • IEnumerable<TSource> ThenBy<TSource, TKey>(this IEnumerable<TSource> @this, Func<TSource, TKey> keySelector, IComparer<TKey> comparer)
  • TSource First<TSource>(this IEnumerable<TSource> @this)
  • TSource First<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate)
  • TSource FirstOrDefault<TSource>(this IEnumerable<TSource> @this)
  • TSource FirstOrDefault<TSource>(this IEnumerable<TSource> @this, TSource defaultValue)
  • TSource FirstOrDefault<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate)
  • TSource FirstOrDefault<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate, TSource defaultValue)
  • TSource Single<TSource>(this IEnumerable<TSource> @this)
  • TSource Single<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate)
  • TSource SingleOrDefault<TSource>(this IEnumerable<TSource> @this)
  • TSource SingleOrDefault<TSource>(this IEnumerable<TSource> @this, TSource defaultValue)
  • TSource SingleOrDefault<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate, TSource defaultValue)
  • TSource SingleOrDefault<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate)
  • TSource Last<TSource>(this IEnumerable<TSource> @this)
  • TSource Last<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate)
  • TSource LastOrDefault<TSource>(this IEnumerable<TSource> @this)
  • TSource LastOrDefault<TSource>(this IEnumerable<TSource> @this, TSource defaultValue)
  • TSource LastOrDefault<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate)
  • TSource LastOrDefault<TSource>(this IEnumerable<TSource> @this, Func<TSource, bool> predicate, TSource defaultValue)
  • TSource Min<TSource>(this IEnumerable<TSource> source)
  • TItem MinBy<TItem, TKey>(this IEnumerable<TItem> @this, Func<TItem, TKey> keySelector)
  • TItem MinBy<TItem, TKey>(this IEnumerable<TItem> @this, Func<TItem, TKey> keySelector, IComparer<TKey> comparer)
  • TSource Max<TSource>(this IEnumerable<TSource> source)
  • TItem MaxBy<TItem, TKey>(this IEnumerable<TItem> @this, Func<TItem, TKey> keySelector)
  • TItem MaxBy<TItem, TKey>(this IEnumerable<TItem> @this, Func<TItem, TKey> keySelector, IComparer<TKey> comparer)
  • IEnumerable<IGrouping<TKey, TSource>> GroupBy<TSource, TKey>(IEnumerable<TSource> source, Func<TSource, TKey> keySelector)
  • IEnumerable<TItem> Prepend<TItem>(this IEnumerable<TItem> @this, TItem item)
  • IEnumerable<TItem> Append<TItem>(this IEnumerable<TItem> @this, TItem item)
  • bool TryGetNonEnumeratedCount<TItem>(this IEnumerable<TItem> source, out int count)
  • IEnumerable<TItem> Zip<TFirst, TSecond, TResult>(IEnumerable<TFirst> @this, IEnumerable<TSecond> second, Func<TFirst, TSecond, TResult> resultSelector)

• System.Random

  • long NextInt64(this Random @this)
  • long NextInt64(this Random @this, long maxValue)
  • long NextInt64(this Random @this, long minValue, long maxValue)

• System.Reflection.Assembly

  • Attribute GetCustomAttribute(this Assembly element, Type attributeType)
  • T GetCustomAttribute<T>(this Assembly element)
  • IEnumerable<Attribute> GetCustomAttributes(this Assembly element)
  • IEnumerable<Attribute> GetCustomAttributes(this Assembly element, Type attributeType)
  • IEnumerable<T> GetCustomAttributes<T>(this Assembly element)
  • bool IsDefined(this Assembly element, Type attributeType)

• System.Reflection.Module

  • Attribute GetCustomAttribute(this Module element, Type attributeType)
  • T GetCustomAttribute<T>(this Module element)
  • IEnumerable<Attribute> GetCustomAttributes(this Module element)
  • IEnumerable<Attribute> GetCustomAttributes(this Module element, Type attributeType)
  • IEnumerable<T> GetCustomAttributes<T>(this Module element)
  • bool IsDefined(this Module element, Type attributeType)

• System.Reflection.MemberInfo

  • Attribute GetCustomAttribute(this MemberInfo element, Type attributeType)
  • Attribute GetCustomAttribute(this MemberInfo element, Type attributeType, bool inherit)
  • T GetCustomAttribute<T>(this MemberInfo element)
  • T GetCustomAttribute<T>(this MemberInfo element, bool inherit)
  • IEnumerable<Attribute> GetCustomAttributes(this MemberInfo element)
  • IEnumerable<Attribute> GetCustomAttributes(this MemberInfo element, bool inherit)
  • IEnumerable<Attribute> GetCustomAttributes(this MemberInfo element, Type attributeType)
  • IEnumerable<Attribute> GetCustomAttributes(this MemberInfo element, Type attributeType, bool inherit)
  • IEnumerable<T> GetCustomAttributes<T>(this MemberInfo element)
  • IEnumerable<T> GetCustomAttributes<T>(this MemberInfo element, bool inherit)
  • bool IsDefined(this MemberInfo element, Type attributeType)
  • bool IsDefined(this MemberInfo element, Type attributeType, bool inherit)

• System.Reflection.ParameterInfo

  • Attribute GetCustomAttribute(this ParameterInfo element, Type attributeType)
  • Attribute GetCustomAttribute(this ParameterInfo element, Type attributeType, bool inherit)
  • T GetCustomAttribute<T>(this ParameterInfo element)
  • T GetCustomAttribute<T>(this ParameterInfo element, bool inherit)
  • IEnumerable<Attribute> GetCustomAttributes(this ParameterInfo element)
  • IEnumerable<Attribute> GetCustomAttributes(this ParameterInfo element, bool inherit)
  • IEnumerable<Attribute> GetCustomAttributes(this ParameterInfo element, Type attributeType)
  • IEnumerable<Attribute> GetCustomAttributes(this ParameterInfo element, Type attributeType, bool inherit)
  • IEnumerable<T> GetCustomAttributes<T>(this ParameterInfo element)
  • IEnumerable<T> GetCustomAttributes<T>(this ParameterInfo element, bool inherit)
  • bool IsDefined(this ParameterInfo element, Type attributeType)
  • bool IsDefined(this ParameterInfo element, Type attributeType, bool inherit)

• System.Reflection.MethodInfo

  • Delegate CreateDelegate(this MethodInfo @this, Type result)

• System.String

  • bool Contains(this string @this, string value, StringComparison comparisonType)
  • bool Contains(this string @this, char value)
  • bool Contains(this string @this, char value, StringComparison comparisonType)
  • string[] Split(this string @this, char separator, StringSplitOptions options = StringSplitOptions.None)
  • string[] Split(this string @this, char separator, int count, StringSplitOptions options = StringSplitOptions.None)
  • string[] Split(this string @this, string separator, StringSplitOptions options = StringSplitOptions.None)
  • string[] Split(this string @this, string separator, int count, StringSplitOptions options = StringSplitOptions.None)
  • int IndexOf(this string @this, char value, StringComparison comparisonType)
  • ReadOnlySpan<char> AsSpan(this string @this)
  • ReadOnlySpan<char> AsSpan(this string @this, int start)
  • ReadOnlySpan<char> AsSpan(this string @this, int start, int length)
  • ReadOnlySpan<char> AsSpan(this string @this, Index startIndex)
  • ReadOnlySpan<char> AsSpan(this string @this, Range range)

• System.RuntimeServices.CompilerServices.RuntimeHelpers

  • T[] GetSubArray<T>(T[] array, Range range)
  • int OffsetToStringData

• System.Text.StringBuilder

  • void Clear(this StringBuilder @this)

• System.Threading.Tasks

  • TaskAwaiter GetAwaiter(this Task task)
  • TaskAwaiter<TResult> GetAwaiter<TResult>(this Task<TResult> task)
  • ConfiguredTaskAwaitable ConfigureAwait(this Task task, bool continueOnCapturedContext)
  • ConfiguredTaskAwaitable<TResult> ConfigureAwait<TResult>(this Task<TResult> task, bool continueOnCapturedContext)

• System.Threading.WaitHandle

  • void Dispose(this WaitHandle @this)

Installation

You can install the FrameworkExtensions.Backports package via NuGet Package Manager or the .NET CLI:

NuGet Package Manager

Install-Package FrameworkExtensions.Backports

.NET CLI

dotnet add package FrameworkExtensions.Backports

Usage

Below are some examples of how to use the features provided by this package. Note that the namespaces are kept original, so no additional using directives are needed.

Range and Index

public class Program
{
    public static void Main()
    {
        int[] numbers = { 1, 2, 3, 4, 5 };
        var slice = numbers[1..^1];
        Console.WriteLine(string.Join(", ", slice)); // Output: 2, 3, 4
    }
}

Lazy Initialization

public class Program
{
    private static Lazy<int> lazyValue = new Lazy<int>(() => ComputeValue());

    public static void Main()
    {
        Console.WriteLine(lazyValue.Value); // Output: Computed Value
    }

    private static int ComputeValue()
    {
        Console.WriteLine("Computed Value");
        return 42;
    }
}

LINQ Methods

using System.Collections.Generic;
using System.Linq;

public class Program
{
    public static void Main()
    {
        List<int> numbers = new List<int> { 1, 2, 3, 4, 5 };

        var max = numbers.Max();
        var minBy = numbers.MinBy(n => n);

        Console.WriteLine($"Max: {max}");    // Output: Max: 5
        Console.WriteLine($"MinBy: {minBy}");// Output: MinBy: 1
    }
}

Task Extensions

using System.Threading.Tasks;

public class Program
{
    public static async Task Main()
    {
        Task task = Task.Delay(1000);
        await task.ConfigureAwait(false);
        Console.WriteLine("Task completed");
    }
}

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch with a descriptive name.
3. Make your changes.
4. Remember: Everything public in here should polyfill existing Microsoft functionality and thus should be mentioned in the Readme with a link to its original documentation.
5. Submit a pull request.

License

This project is licensed under the LGPL-3.0-or-later License. See the LICENSE file for details.

Acknowledgments

We appreciate the contributions of the .NET community in making this package possible.