I am delighted to announce the release of Spargine 10 (v2026.10.10.1) on October 1st, 2026. Spargine, my open-source project, now offers NuGet packages for .NET 10. I’ve integrated these enhancements across all my projects. I encourage you to explore these updates and share any feedback or suggestions for further improvements.
This version supports .NET 10, introduces new types, methods, benchmarks, and comprehensive unit tests, all aimed at improving Spargine’s performance and reliability! Notably, this release includes speed enhancements informed by benchmark tests outlined in the 5th edition of Rock Your Code: Code & App Performance for Microsoft .NET, available on Amazon.
GitHub: https://github.com/RealDotNetDave/dotNetTips.Spargine.10/releases
NuGet: http://bit.ly/dotNetDaveNuGet
You can access all the performance data for these assemblies on GitHub. I’m always seeking help with these projects. If you are interested in contributing, please don’t hesitate to contact me via email at dotnetdave@live.com. Your support and collaboration are highly appreciated!
New Classes and Methods
Below are the new classes and methods added to this version of Spargine.
dotNetTips.Spargine
| Type | Method | Description |
| HttpClientHelper | CreateOptimizedHttpClient() | Creates a new, performance-optimized HttpClient instance configured with the specified options. |
dotNetTips.Spargine.Core
| Type | Method | Description |
| TaskHelper | GetUnderlyingType() | Gets the underlying type for a nullable type. |
| TaskHelper | RunSync() | Executes the specified asynchronous ValueTask synchronously on a background thread. Overloaded to also return a TResult. |
| ThreadPoolHelper * New Type | RunAsync() | Queues an operation to the managed thread pool and waits for the result. |
| ThreadPoolHelper | RunWhenAnyAsync() | Queues multiple operations to the managed thread pool and returns the result of the first operation to complete. |
| ThreadPoolHelper | TryRunAsync() | Queues an operation to the managed thread pool and captures the outcome in a SimpleResult without throwing on failure. |
| ThreadPoolHelper | GetStatistics() | Gets a point-in-time snapshot of the managed thread pool statistics. |
dotNetTips.Spargine.Extentions
| Type | Method | Description |
| CollectionExtensions | AddRangeIfNotExists() | Adds items from items to the collection only when they do not already exist. |
| CollectionExtensions | RemoveWhere() | Removes each item from the collection that satisfies the supplied predicate. |
| CollectionExtensions | TryGetFirst() | Tries to get the first item in the sequence without throwing or allocating an enumerator when the source is an IList. |
| DateTimeExtensions | Clamp() | Clamps a DateTime to the inclusive range defined by minimum and maximum. |
| DateTimeExtensions | EndOfDay() | Returns the last tick of the day for the specified DateTime or DateTimeOffset. |
| DateTimeExtensions | RoundToNearestMultiple() | Rounds a DateTime to the nearest multiple of multiple. |
| DateTimeExtensions | StartOfDay() | Returns midnight (00:00:00) of the DateTime or DateTimeOffset. |
| DateTimeExtensions | ToDateOnly() | Converts a DateTime to a DateOnly representing only the date component. |
| DateTimeExtensions | ToTimeOnly() | Converts a DateTime to a TimeOnly representing only the time component. |
| DateTimeExtensions | TryParseInvariant() | Attempts to parse a DateTime from a ReadOnlySpan using invariant culture. |
| DictionaryExtensions * New type | GetOrAdd() | Gets the value associated with the specified key, or adds a newly created value from valueFactory. |
| DictionaryExtensions | TryGetValueOrDefault() | Gets the value associated with the specified key, or returns defaultValue when the key is not found. |
| DictionaryExtensions | TryRemoveAndReturn() | Attempts to remove the value with the specified key and returns the removed value when found. |
| DirectoryInfoExtensions | ReadAllTextSafe() | Reads all text from the file in this directory and returns a fallback when the read fails. |
| DirectoryInfoExtensions | WriteAllTextAtomic() | Writes text atomically to a file within the directory. |
| DirectoryInfoExtensions | CreateTempFileThenMove() | Creates a temporary file in a directory and atomically moves it to a destination. |
| EfCoreModelBuilderExtensions * New type | RegisterEnumAsStringConverters() | Registers enum-to-string value converters for all enum and nullable enum properties in the current model. Existing property-level converters are preserved. |
| FileInfoExtensions | CreateTempFileThenMove() | Creates a temporary file in the same directory and atomically moves it to a new file. |
| FileInfoExtensions | ReadAllTextSafe() | Reads all text from the file and returns a fallback when file access fails. |
| FileInfoExtensions | WriteAllTextAtomic() | Writes text atomically by writing to a temp file then moving/replacing the target file. |
| MemoryExtensions *New type | IsEqualTo() | Determines whether the current Memory is equal to other by comparing elements. |
| MemoryExtensions | ToArrayIfNeeded() | Returns the elements of this Memory as an array, avoiding a copy when possible. |
| MemoryExtensions | TryGetArraySegment() | Attempts to retrieve the underlying ArraySegment that backs this Memory without copying. |
| MemoryExtensions | IsNotEmpty() | Determines whether the Memory contains any elements. |
| MessagePackExtensions *New type | ToMessagePackBytes() | Serializes the specified value to MessagePack bytes. |
| MessagePackExtensions | FromMessagePack() | Deserializes the specified MessagePack bytes into an instance of T. |
| NumericExtensions | Clamp() | Clamps an int to the inclusive range defined by minimum and maximum. |
| NumericExtensions | RoundToNearestMultiple() | Rounds an int to the nearest multiple of multiple using midpoint rounding away from zero. |
| NumericExtensions | TryParseInvariant() | Attempts to parse an int from a ReadOnlySpan using invariant culture. |
| OpenTelemetryExtensions * New type | SetStatusIfError() | Sets the activity status to ActivityStatusCode.Error when an exception is present. |
| OpenTelemetryExtensions | AddTagsIfPresent() | Adds tags to an Activity when both key and value are present. |
| ReadOnlyMemoryExtensions * New type | IsEqualTo() | Determines whether the current ReadOnlyMemory is equal to other by comparing elements. |
| ReadOnlyMemoryExtensions | ToArrayIfNeeded() | Returns the elements of this ReadOnlyMemory as an array, avoiding a copy when possible. |
| ReadOnlyMemoryExtensions | TryGetArraySegment() | Attempts to retrieve the underlying ArraySegment that backs this ReadOnlyMemory without copying. |
| ReadOnlyMemoryExtensions | IsNotEmpty() | Determines whether the ReadOnlyMemory contains any elements. |
| StreamExtensions | CopyToAsyncPooled() | Copies all bytes from a source to a destination asynchronously using a pooled buffer. |
| StreamExtensions | ReadExactlyAsync() | Reads exactly buffer.Length bytes from a stream. |
| StreamExtensions | WriteAllAsync() | Writes all bytes from a buffer to a stream asynchronously. |
| StringExtensions | FormatCurrentCulture() | Formats the specified composite format using CultureInfo.CurrentCulture and cached CompositeFormat parsing. |
| StringExtensions | FormatInvariant() | Formats the specified composite format using CultureInfo.InvariantCulture and cached CompositeFormat parsing. |
| StringExtensions | JoinFormatted() | Formats each value in args using the specified composite format and joins the results using delimiter. |
| TaskExtensions | IqnoreCancellation() | Observes the task and suppresses cancellation exceptions while allowing other exceptions to propagate. |
| TaskExtensions | UnwrapAggregate() | Returns the innermost single exception when the source is an AggregateException; otherwise returns the original exception. |
| TaskExtensions | WithTimeoutAsync() | Awaits completion of the task within the specified timeout. |
dotNetTips.Spargine.Benchmark
| Type | Method | Description |
| Benchmark | ConsumeAsyncEnumerableAsync() | Enumerates and consumes every element of an asynchronous sequence. |
| Benchmark | CreateTemporaryDirectory() | Creates a unique temporary directory owned by this benchmark instance. |
| Benchmark | GetByteArrayByLength() | Retrieves a cached mutable byte array with an exact length, including zero. |
| Benchmark | GlobalCleanupAsync() | Awaits the cleanup hook and then removes this instance’s tracked temporary directories. |
| Benchmark | GlobalSetupAsync() | Optionally launches the debugger and dispatches asynchronous benchmark initialization. |
| CollectionBenchmark | ClearCollectionCaches() | Clears all in-memory collection caches held by this benchmark instance. |
| CollectionBenchmark | ClearPersonCaches() | Clears the in-memory person collection caches and replaces them with empty lists. |
| CollectionBenchmark | CopyCoordinateValTo() | Copies the internal value-type coordinate buffer into the provided destination span. |
| CollectionBenchmark | GetCoordinateRefArray() | Gets a clone of the Coordinate array. This method ensures that benchmarks operate on a fresh copy of the data, preventing modifications from affecting subsequent benchmark runs. |
| CollectionBenchmark | GetCoordinateRefCollection() | Gets a clone of the Coordinate list as a Collection<T>. |
| CollectionBenchmark | GetCoordinateRefReadOnlySpan() | Returns a ReadOnlySpan over the internal reference-type coordinate array. |
| CollectionBenchmark | GetCoordinateValArray() | Gets a clone of the Coordinate array. This method ensures that benchmarks operate on a fresh copy of the data, preventing modifications from affecting subsequent benchmark runs. |
| CollectionBenchmark | GetCoordinateValCollection() | Gets a clone of the Coordinate list as a Collection<T>. |
| CollectionBenchmark | GetCoordinateValReadOnlySpan() | Returns a ReadOnlySpan over the internal value-type coordinate array. |
| CollectionBenchmark | GetPersonRecordCollectionToInsert() | Gets a collection of PersonRecord objects for insertion into collections. |
| CollectionBenchmark | GetPersonRecordDictionary() | Gets a cloned dictionary for PersonRecord. |
| CollectionBenchmark | GetPersonRecordReadOnlySpan() | Returns a read-only span over the internal PersonRecord list. |
| CollectionBenchmark | GetPersonRefCollectionToInsert() | Gets a collection of Person reference objects for insertion into collections. |
| CollectionBenchmark | GetPersonRefReadOnlySpan() | Returns a read-only span over the internal Person reference-type list. |
| CollectionBenchmark | GetPersonValCollectionToInsert() | Gets a collection of ValueTypes.Person value objects for insertion into collections. |
| CollectionBenchmark | GetPersonValDictionary() | Gets clone of person value dictionary. |
| CollectionBenchmark | GetPersonValReadOnlySpan() | Returns a read-only span over the internal Person value-type list. |
| CollectionBenchmark | LoadCoordinateCollections() | Loads the coordinate collections into memory. This includes both a list and an array of Coordinate objects, populated to the maximum count specified for the benchmark. This method is called to prepare data for benchmark tests. |
| CollectionBenchmark | ReloadCollections() | Reloads the coordinate and person collections and refreshes the lookup values. |
| CollectionBenchmark | TryFindPersonRefById() | Attempts to find a Person reference with the specified id in the internal list. |
| ReturnValueColumnConfig *New Type | Provides a ManualConfig that adds the ReturnValueColumn to BenchmarkDotNet output. |
dotNetTips.Spargine.Tester
| Type | Method | Description |
| RandomData | GenerateBoolean() | Generates a random boolean value. |
| RandomData | GenerateCompanyName() | Generates a random company name. |
| RandomData | GenerateCurrencyAmount() | Generates a random currency amount with the specified decimal places. |
| RandomData | GenerateDateOnly() | Generates a random DateOnly within a specified range. |
| RandomData | GenerateDateTimeOffset() | Generates a random DateTimeOffset within a specified range. |
| RandomData | GenerateEnum() | Generates a random value from the specified enum type. |
| RandomData | GenerateGuid() | Generates a new GUID value. |
| RandomData | GenerateHashString() | Generates a random hexadecimal hash string of the specified length. |
| RandomData | GenerateIPv4Address() | Generates a random IPv4 address string. |
| RandomData | GenerateIPv6Address() | Generates a random IPv6 address string. |
| RandomData | GenerateJsonObject() | Generates a random JSON object string with the specified number of properties. |
| RandomData | GenerateParagraph() | Generates a random paragraph with the specified number of sentences. |
| RandomData | GenerateSentence() | Generates a random sentence with the specified number of words. |
| RandomData | GenerateTimeOnly() | Generates a random TimeOnly within a specified range. |
| RandomData | GenerateTimeSpan() | Generates a random TimeSpan within a specified range. |
Performance Enhancements: Significant Speed Improvements Across Methods
With every new release of Spargine, I continue to refine performance, reduce allocations, and improve the library’s overall efficiency. The .NET 10 version delivers substantial speed gains through many methods, with several benchmarks showing significant improvements.
Some of these gains came from careful tuning, repeated benchmarking, and focused code reviews. I also tested performance recommendations from Copilot, although the results were mixed. At the moment, roughly 60% of the performance changes suggested by Copilot make the method slower, which is a good reminder that every optimization must be validated with real benchmarks.
The results below highlight some of the most notable performance gains in this release, specifically methods that improved by 2x or more. In several cases, allocations also dropped dramatically, and some methods reduced allocations by 100%. That is a major win for performance-sensitive applications.
In this release, 340 methods in Spargine showed performance improvements. Here are the most notable speed increases:
- App.ProcessId(): 2.45x faster
- ArrayExtensions.AreEqual(): 2.3x faster
- CharacterExtensions.ToAsciiLower(): 87.52x faster
- CharacterExtensions.ToAsciiUpper(): 13.26x faster
- DirectoryHelper.SetFileAttributesToNormal(): 39.08x faster
- EnumerableExtensions.FastLongCount(): 3.38x faster
- EnumerableExtensions.IsEmpty([]): 2.89x faster.
- FileHelper.FileHasInvalidChars(): 12.42x faster
- ObjectExtensions.IsNotNull(): 17.03x faster.
- PathHelper.HasInvalidFilterChars(): 26.15x faster
- PathHelper.PathHasInvalidChars(): 7.01x faster
- StringExtensions.HasValue(): 14.49x faster.
Summary
I’m confident these new and enhanced Spargine features will significantly improve your projects by boosting both performance and reliability. Detailed benchmark results are available on GitHub for those who want to dig deeper.
As always, open-source thrives on community involvement. If you find these updates helpful — or have ideas for future improvements — I encourage you to jump in. Whether through pull requests, issue reports, or feature suggestions, your contributions are invaluable.
Together, we can continue to make Spargine a robust and indispensable tool for the .NET community. Your feedback is always welcome, so please share your thoughts in the comments.
If my work has helped you write faster, cleaner, rock-solid .NET code, I’d love your support through GitHub Sponsors. Your sponsorship helps fuel new features, benchmarks, tools, and learning resources for the entire community. Join the crew here: https://github.com/sponsors/RealDotNetDave — and thanks for helping keep the code loud and fast!Thank you for your support — and keep coding faster, smarter, and better!
Do you have suggestions for Spargine?
If I use your suggestion and you live in the US or a country I am traveling to, to speak at a conference, I will send you some cool geeky swag!
Pick up any books by David McCarter by going to Amazon.com: http://bit.ly/RockYourCodeBooks
Make a one-time donation
Make a monthly donation
Make a yearly donation
Choose an amount
Or enter a custom amount
Your contribution is appreciated.
Your contribution is appreciated.
Your contribution is appreciated.
If you liked this article, please buy David a cup of Coffee by going here: https://www.buymeacoffee.com/dotnetdave
© The information in this article is copywritten and cannot be reproduced in any way without express permission from David McCarter.
Discover more from dotNetTips.com
Subscribe to get the latest posts sent to your email.
