Microsoft.Extensions.Primitives 10.0.0-preview.3.25171.5

About

Microsoft.Extensions.Primitives contains isolated types that are used in many places within console or ASP.NET Core applications using framework extensions.

Key Features

  • IChangeToken: An interface that represents a token that can notify when a change occurs. This can be used to trigger actions or invalidate caches when something changes. For example, the configuration and file providers libraries use this interface to reload settings or files when they are modified.
  • StringValues: A struct that represents a single string or an array of strings. This can be used to efficiently store and manipulate multiple values that are logically a single value. For example, the HTTP headers and query strings libraries use this struct to handle multiple values for the same key.
  • StringSegment: A struct that represents a substring of another string. This can be used to avoid allocating new strings when performing operations on parts of a string. For example, the configuration and logging libraries use this struct to parse and format strings.

How to Use

IChangeToken with configuration example

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Primitives;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Create a configuration builder
        var configurationBuilder = new ConfigurationBuilder()
            .SetBasePath(Environment.CurrentDirectory)
            // appsettings.json expected to have the following contents:
            // {
            //   "SomeKey": "SomeValue"
            // }
            .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true);

        // Build the configuration
        IConfiguration configuration = configurationBuilder.Build();

        // Create a change token for the configuration
        IChangeToken changeToken = configuration.GetReloadToken();

        // Attach a change callback
        IDisposable changeTokenRegistration = changeToken.RegisterChangeCallback(state =>
        {
            Console.WriteLine("Configuration changed!");
            IConfigurationRoot root = (IConfigurationRoot)state;
            var someValue = root["SomeKey"]; // Access the updated configuration value
            Console.WriteLine($"New value of SomeKey: {someValue}");
        }, configuration);

        // go and update the value of the key SomeKey in appsettings.json.
        // The change callback will be invoked when the file is saved.
        Console.WriteLine("Listening for configuration changes. Press any key to exit.");
        Console.ReadKey();

        // Clean up the change token registration when no longer needed
        changeTokenRegistration.Dispose();
    }
}

StringValues example

using System;
using Microsoft.Extensions.Primitives;

namespace StringValuesSample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a StringValues object from a single string or an array of strings
            StringValues single = "Hello";
            StringValues multiple = new string[] { "Hello", "World" };

            // Use the implicit conversion to string or the ToString method to get the values
            Console.WriteLine($"Single: {single}"); // Single: Hello
            Console.WriteLine($"Multiple: {multiple}"); // Multiple: Hello,World

            // Use the indexer, the Count property, and the IsNullOrEmpty method to access the values
            Console.WriteLine($"Multiple[1]: {multiple[1]}"); // Multiple[1]: World
            Console.WriteLine($"Single.Count: {single.Count}"); // Single.Count: 1
            Console.WriteLine($"Multiple.IsNullOrEmpty: {StringValues.IsNullOrEmpty(multiple)}"); // Multiple.IsNullOrEmpty: False

            // Use the Equals method or the == operator to compare two StringValues objects
            Console.WriteLine($"single == \"Hello\": {single == "Hello"}"); // single == "Hello": True
            Console.WriteLine($"multiple == \"Hello\": {multiple == "Hello"}"); // multiple == "Hello": False
       }
    }
}

Main Types

The main types provided by this library are:

  • IChangeToken
  • StringValues
  • StringSegment

Additional Documentation

Feedback & Contributing

Microsoft.Extensions.Primitives is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Showing the top 20 packages that depend on Microsoft.Extensions.Primitives.

Packages Downloads
Microsoft.Extensions.Configuration
Implementation of key-value pair based configuration for Microsoft.Extensions.Configuration. Includes the memory configuration provider.
2,250
Microsoft.Extensions.Caching.Memory
In-memory cache implementation of Microsoft.Extensions.Caching.Memory.IMemoryCache.
2,187
Microsoft.Extensions.Options
Provides a strongly typed way of specifying and accessing settings using dependency injection.
2,177
Microsoft.Extensions.Caching.Memory
In-memory cache implementation of Microsoft.Extensions.Caching.Memory.IMemoryCache.
2,167
Microsoft.Extensions.Options
Provides a strongly typed way of specifying and accessing settings using dependency injection.
2,166
Microsoft.Extensions.Configuration.Abstractions
Provides abstractions of key-value pair based configuration. Interfaces defined in this package are implemented by classes in Microsoft.Extensions.Configuration and other configuration packages.
2,166
Microsoft.Extensions.FileProviders.Abstractions
Abstractions of files and directories. Commonly Used Types: Microsoft.Extensions.FileProviders.IDirectoryContents Microsoft.Extensions.FileProviders.IFileInfo Microsoft.Extensions.FileProviders.IFileProvider
2,165
Microsoft.Extensions.Caching.Abstractions
Caching abstractions for in-memory cache and distributed cache. Commonly Used Types: Microsoft.Extensions.Caching.Distributed.IDistributedCache Microsoft.Extensions.Caching.Memory.IMemoryCache
2,164
Microsoft.Extensions.FileProviders.Physical
File provider for physical files for Microsoft.Extensions.FileProviders.
2,163
Microsoft.Extensions.Options
Provides a strongly typed way of specifying and accessing settings using dependency injection.
2,157
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
2,155
Microsoft.Extensions.Configuration
Implementation of key-value pair based configuration for Microsoft.Extensions.Configuration. Includes the memory configuration provider.
2,155
Microsoft.Extensions.Logging.EventSource
EventSource/EventListener logger provider implementation for Microsoft.Extensions.Logging.
2,154
Microsoft.Extensions.Options
Provides a strongly typed way of specifying and accessing settings using dependency injection.
2,146
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
2,144
Microsoft.Extensions.Caching.Memory
In-memory cache implementation of Microsoft.Extensions.Caching.Memory.IMemoryCache.
2,072
Microsoft.Extensions.Caching.Memory
In-memory cache implementation of Microsoft.Extensions.Caching.Memory.IMemoryCache.
1,502
Microsoft.Extensions.Options
Provides a strongly typed way of specifying and accessing settings using dependency injection.
1,127
Microsoft.Extensions.Configuration.Abstractions
Provides abstractions of key-value pair based configuration. Interfaces defined in this package are implemented by classes in Microsoft.Extensions.Configuration and other configuration packages.
1,043
Microsoft.Extensions.Options
Provides a strongly typed way of specifying and accessing settings using dependency injection.
940

.NET Framework 4.6.2

.NET 8.0

  • No dependencies.

.NET 9.0

  • No dependencies.

.NET 10.0

  • No dependencies.

.NET Standard 2.0

Version Downloads Last updated
11.0.0 6 11/12/2026
11.0.0-rc.3.26522.148 17 10/26/2026
11.0.0-rc.2.26504.105 20 10/13/2026
11.0.0-rc.1.26425.128 25 09/09/2026
11.0.0-preview.7.26381.103 26 08/12/2026
11.0.0-preview.6.26359.118 29 07/15/2026
11.0.0-preview.5.26302.115 33 06/10/2026
11.0.0-preview.4.26230.115 38 05/14/2026
11.0.0-preview.3.26207.106 45 04/14/2026
11.0.0-preview.2.26159.112 35 03/12/2026
11.0.0-preview.1.26104.118 55 02/12/2026
10.0.15 7 11/12/2026
10.0.14 12 10/26/2026
10.0.13 27 10/13/2026
10.0.12 22 09/09/2026
10.0.11 167 08/12/2026
10.0.10 28 07/15/2026
10.0.9 36 06/10/2026
10.0.8 44 05/14/2026
10.0.7 2,176 04/23/2026
10.0.6 43 04/14/2026
10.0.5 90 03/14/2026
10.0.4 90 03/12/2026
10.0.3 404 02/11/2026
10.0.2 89 01/14/2026
10.0.1 796 09/28/2026
10.0.0 38 09/28/2026
10.0.0-rc.2.25502.107 41 12/12/2025
10.0.0-rc.1.25451.107 48 12/12/2025
10.0.0-preview.7.25380.108 34 12/12/2025
10.0.0-preview.6.25358.103 53 12/11/2025
10.0.0-preview.5.25277.114 51 12/11/2025
10.0.0-preview.4.25258.110 29 12/11/2025
10.0.0-preview.3.25171.5 40 12/12/2025
10.0.0-preview.2.25163.2 41 12/12/2025
10.0.0-preview.1.25080.5 45 12/12/2025
9.0.23 8 11/12/2026
9.0.22 11 10/26/2026
9.0.21 23 10/14/2026
9.0.20 20 09/09/2026
9.0.19 26 08/12/2026
9.0.18 24 07/15/2026
9.0.17 35 06/10/2026
9.0.16 33 05/14/2026
9.0.15 53 04/14/2026
9.0.14 49 03/12/2026
9.0.13 43 02/12/2026
9.0.12 56 01/14/2026
9.0.11 65 12/12/2025
9.0.10 45 12/16/2025
9.0.9 57 12/12/2025
9.0.8 10 09/28/2026
9.0.7 12 09/28/2026
9.0.6 8 09/29/2026
9.0.5 51 12/12/2025
9.0.4 62 12/11/2025
9.0.3 64 12/12/2025
9.0.2 2,076 12/20/2025
9.0.1 7 10/02/2026
9.0.0 881 09/28/2026
9.0.0-rc.2.24473.5 43 12/12/2025
9.0.0-rc.1.24431.7 38 12/12/2025
9.0.0-preview.7.24405.7 44 12/12/2025
9.0.0-preview.6.24327.7 44 12/12/2025
9.0.0-preview.5.24306.7 12 10/14/2026
9.0.0-preview.4.24266.19 56 12/12/2025
9.0.0-preview.3.24172.9 44 12/14/2025
9.0.0-preview.2.24128.5 35 12/12/2025
9.0.0-preview.1.24080.9 47 12/12/2025
8.0.0 1,018 09/28/2026
8.0.0-rc.2.23479.6 45 12/12/2025
8.0.0-rc.1.23419.4 50 12/18/2025
8.0.0-preview.7.23375.6 36 12/12/2025
8.0.0-preview.6.23329.7 45 12/12/2025
8.0.0-preview.5.23280.8 36 12/12/2025
8.0.0-preview.4.23259.5 43 12/12/2025
8.0.0-preview.3.23174.8 43 12/12/2025
8.0.0-preview.2.23128.3 9 09/29/2026
8.0.0-preview.1.23110.8 35 12/12/2025
7.0.0 56 12/12/2025
7.0.0-rc.2.22472.3 45 12/12/2025
7.0.0-rc.1.22426.10 55 12/12/2025
7.0.0-preview.7.22375.6 44 12/12/2025
7.0.0-preview.6.22324.4 31 12/20/2025
7.0.0-preview.5.22301.12 41 12/12/2025
7.0.0-preview.4.22229.4 35 12/20/2025
7.0.0-preview.3.22175.4 37 12/12/2025
7.0.0-preview.2.22152.2 43 12/12/2025
7.0.0-preview.1.22076.8 37 12/12/2025
6.0.2-mauipre.1.22102.15 37 01/06/2026
6.0.2-mauipre.1.22054.8 47 12/11/2025
6.0.1 99 12/12/2025
6.0.0 1,095 12/11/2025
6.0.0-rc.2.21480.5 45 12/12/2025
6.0.0-rc.1.21451.13 40 12/12/2025
6.0.0-preview.7.21377.19 40 12/12/2025
6.0.0-preview.6.21352.12 47 12/12/2025
6.0.0-preview.5.21301.5 29 12/12/2025
6.0.0-preview.4.21253.7 46 12/11/2025
6.0.0-preview.3.21201.4 46 12/12/2025
6.0.0-preview.2.21154.6 13 10/16/2026
6.0.0-preview.1.21102.12 29 12/12/2025
5.0.1 46 12/12/2025
5.0.0 70 12/12/2025
5.0.0-rc.2.20475.5 40 12/12/2025
5.0.0-rc.1.20451.14 38 12/13/2025
5.0.0-preview.8.20407.11 5 09/28/2026
5.0.0-preview.7.20364.11 35 12/14/2025
5.0.0-preview.6.20305.6 41 12/11/2025
5.0.0-preview.5.20278.1 32 12/12/2025
5.0.0-preview.4.20251.6 40 12/12/2025
5.0.0-preview.3.20215.2 41 12/12/2025
5.0.0-preview.2.20160.3 35 12/12/2025
5.0.0-preview.1.20120.4 45 12/12/2025
3.1.32 67 12/12/2025
3.1.31 45 12/12/2025
3.1.30 42 12/12/2025
3.1.29 53 12/11/2025
3.1.28 16 09/30/2026
3.1.27 40 12/12/2025
3.1.26 15 09/29/2026
3.1.25 51 12/20/2025
3.1.24 43 12/12/2025
3.1.23 46 12/12/2025
3.1.22 45 12/11/2025
3.1.21 40 12/20/2025
3.1.20 46 12/12/2025
3.1.19 46 12/20/2025
3.1.18 32 12/12/2025
3.1.17 42 12/12/2025
3.1.16 49 12/12/2025
3.1.15 13 10/08/2026
3.1.14 33 12/15/2025
3.1.13 16 09/28/2026
3.1.12 49 12/12/2025
3.1.11 39 12/20/2025
3.1.10 34 12/12/2025
3.1.9 31 12/12/2025
3.1.8 63 12/12/2025
3.1.7 54 12/12/2025
3.1.6 50 12/15/2025
3.1.5 34 12/12/2025
3.1.4 62 12/11/2025
3.1.3 13 09/30/2026
3.1.2 47 12/12/2025
3.1.1 37 12/14/2025
3.1.0 12 09/28/2026
3.1.0-preview3.19553.2 42 12/12/2025
3.1.0-preview2.19525.4 32 12/12/2025
3.1.0-preview1.19506.1 42 12/12/2025
3.0.3 44 12/12/2025
3.0.2 51 12/12/2025
3.0.1 36 12/12/2025
3.0.0 46 12/12/2025
3.0.0-rc1.19456.10 44 12/12/2025
3.0.0-preview9.19423.4 35 12/12/2025
3.0.0-preview8.19405.4 39 12/12/2025
3.0.0-preview7.19362.4 36 12/12/2025
3.0.0-preview6.19304.6 51 12/12/2025
3.0.0-preview5.19227.9 40 12/12/2025
3.0.0-preview4.19216.2 46 12/20/2025
3.0.0-preview3.19153.1 33 12/15/2025
3.0.0-preview.19074.2 51 12/18/2025
3.0.0-preview.18572.1 45 12/14/2025
2.2.0 209 12/20/2025
2.2.0-preview3-35497 40 12/20/2025
2.2.0-preview2-35157 41 12/20/2025
2.2.0-preview1-35029 39 12/20/2025
2.1.6 48 12/15/2025
2.1.1 34 09/28/2026
2.1.0 50 12/20/2025
2.1.0-rc1-final 42 12/14/2025
2.1.0-preview2-final 38 12/20/2025
2.1.0-preview1-final 48 12/20/2025
2.0.0 66 12/18/2025
2.0.0-preview2-final 37 12/20/2025
2.0.0-preview1-final 13 10/06/2026
1.1.1 816 09/28/2026
1.1.0 48 12/11/2025
1.1.0-preview1-final 33 12/20/2025
1.0.1 40 12/20/2025
1.0.0 42 12/14/2025
1.0.0-rc2-final 48 12/20/2025
1.0.0-rc1-final 29 12/20/2025