System.Collections.Immutable 10.0.0-preview.3.25171.5

About

This package provides collections that are thread safe and guaranteed to never change their contents, also known as immutable collections. Like strings, any methods that perform modifications will not change the existing instance but instead return a new instance. For efficiency reasons, the implementation uses a sharing mechanism to ensure that newly created instances share as much data as possible with the previous instance while ensuring that operations have a predictable time complexity.

The System.Collections.Immutable library is built-in as part of the shared framework in .NET Runtime. The package can be installed when you need to use it in other target frameworks.

How to Use

using System.Collections.Immutable;

// Create immutable set of strings
ImmutableHashSet<string> colors = ImmutableHashSet.Create("Red", "Green", "Blue");

// Create a new set by adding and removing items from the original set
ImmutableHashSet<string> colorsModified = colors.Remove("Red").Add("Orange");

foreach (string s in colorsModified)
{
    Console.WriteLine(s);
}

/* Example output:
 Blue
 Green
 Orange
 */

Main Types

The main types provided by this library are:

  • System.Collections.Immutable.ImmutableArray
  • System.Collections.Immutable.ImmutableArray<T>
  • System.Collections.Immutable.ImmutableDictionary
  • System.Collections.Immutable.ImmutableDictionary<TKey,TValue>
  • System.Collections.Immutable.ImmutableHashSet
  • System.Collections.Immutable.ImmutableHashSet<T>
  • System.Collections.Immutable.ImmutableList
  • System.Collections.Immutable.ImmutableList<T>
  • System.Collections.Immutable.ImmutableQueue
  • System.Collections.Immutable.ImmutableQueue<T>
  • System.Collections.Immutable.ImmutableSortedDictionary
  • System.Collections.Immutable.ImmutableSortedDictionary<TKey,TValue>
  • System.Collections.Immutable.ImmutableSortedSet
  • System.Collections.Immutable.ImmutableSortedSet<T>
  • System.Collections.Immutable.ImmutableStack
  • System.Collections.Immutable.ImmutableStack<T>
  • System.Collections.Frozen.FrozenDictionary
  • System.Collections.Frozen.FrozenDictionary<TKey, TValue>
  • System.Collections.Frozen.FrozenSet
  • System.Collections.Frozen.FrozenSet<T>

Additional Documentation

Feedback & Contributing

System.Collections.Immutable 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 System.Collections.Immutable.

Packages Downloads
HotChocolate.Abstractions
Contains common abstractions used between the Hot Chocolate GraphQL type system and the GraphQL query execution engine.
4,803
HotChocolate.Abstractions
Contains common abstractions used between the Hot Chocolate GraphQL type system and the GraphQL query execution engine.
9,325
Microsoft.EntityFrameworkCore
Entity Framework Core is a lightweight and extensible version of the popular Entity Framework data access technology. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
272
Microsoft.EntityFrameworkCore
Entity Framework Core is a lightweight and extensible version of the popular Entity Framework data access technology. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
3,949
Microsoft.EntityFrameworkCore
Entity Framework Core is a lightweight and extensible version of the popular Entity Framework data access technology. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
10,332
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
400
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
814
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
1,801
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
2,638
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
4,799
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
6,287
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
8,899
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
10,112
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
10,850
Microsoft.EntityFrameworkCore
Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet
14,453
Npgsql
Npgsql is the open source .NET data provider for PostgreSQL.
1,592
Npgsql
Npgsql is the open source .NET data provider for PostgreSQL.
6,299
Npgsql
Npgsql is the open source .NET data provider for PostgreSQL.
14,446
System.Reflection.Metadata
This packages provides a low-level .NET (ECMA-335) metadata reader and writer. It's geared for performance and is the ideal choice for building higher-level libraries that intend to provide their own object model, such as compilers. Commonly Used Types: System.Reflection.Metadata.MetadataReader System.Reflection.PortableExecutable.PEReader System.Reflection.Metadata.Ecma335.MetadataBuilder System.Reflection.PortableExecutable.PEBuilder System.Reflection.PortableExecutable.ManagedPEBuilder 30ab651fcb4354552bd4891619a0bdd81e0ebdbf When using NuGet 3.x this package requires at least version 3.4.
14,420
System.Reflection.Metadata
This packages provides a low-level .NET (ECMA-335) metadata reader and writer. It's geared for performance and is the ideal choice for building higher-level libraries that intend to provide their own object model, such as compilers. Commonly Used Types: System.Reflection.Metadata.MetadataReader System.Reflection.PortableExecutable.PEReader System.Reflection.Metadata.Ecma335.MetadataBuilder System.Reflection.PortableExecutable.PEBuilder System.Reflection.PortableExecutable.ManagedPEBuilder When using NuGet 3.x this package requires at least version 3.4.
33,903

https://go.microsoft.com/fwlink/?LinkID=799421

.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
10.0.0-preview.3.25171.5 8 04/11/2025
10.0.0-preview.2.25163.2 8 03/22/2025
10.0.0-preview.1.25080.5 10 02/27/2025
9.0.4 6 04/09/2025
9.0.3 8 03/22/2025
9.0.2 13 02/19/2025
9.0.1 8 01/20/2025
9.0.0 12 11/23/2024
9.0.0-rc.2.24473.5 15 10/14/2024
9.0.0-rc.1.24431.7 14 09/14/2024
9.0.0-preview.7.24405.7 17 08/13/2024
9.0.0-preview.6.24327.7 21 07/09/2024
9.0.0-preview.5.24306.7 20 06/20/2024
9.0.0-preview.4.24266.19 24 05/22/2024
9.0.0-preview.3.24172.9 16 04/17/2024
9.0.0-preview.2.24128.5 17 03/15/2024
9.0.0-preview.1.24080.9 13 03/11/2024
8.0.0 17 11/16/2023
8.0.0-rc.2.23479.6 23 10/19/2023
8.0.0-rc.1.23419.4 27 09/17/2023
8.0.0-preview.7.23375.6 24 09/02/2023
8.0.0-preview.6.23329.7 27 09/10/2023
8.0.0-preview.5.23280.8 21 06/16/2023
8.0.0-preview.4.23259.5 18 05/17/2023
8.0.0-preview.3.23174.8 42 04/24/2023
8.0.0-preview.2.23128.3 37 04/08/2023
8.0.0-preview.1.23110.8 78 04/07/2023
7.0.0 59 12/14/2022
7.0.0-rc.2.22472.3 88 10/15/2022
7.0.0-rc.1.22426.10 42 09/22/2022
7.0.0-preview.7.22375.6 39 09/23/2022
7.0.0-preview.6.22324.4 116 09/23/2022
7.0.0-preview.5.22301.12 85 09/23/2022
7.0.0-preview.4.22229.4 27 09/21/2022
7.0.0-preview.3.22175.4 59 09/23/2022
7.0.0-preview.2.22152.2 27 09/21/2022
7.0.0-preview.1.22076.8 83 09/22/2022
6.0.2-mauipre.1.22102.15 43 09/21/2022
6.0.2-mauipre.1.22054.8 64 09/26/2022
6.0.1 13 11/23/2024
6.0.0 16,361 06/27/2022
6.0.0-rc.2.21480.5 42 09/25/2022
6.0.0-rc.1.21451.13 45 09/21/2022
6.0.0-preview.7.21377.19 73 09/23/2022
6.0.0-preview.6.21352.12 83 09/23/2022
6.0.0-preview.5.21301.5 111 09/23/2022
6.0.0-preview.4.21253.7 40 10/15/2022
6.0.0-preview.3.21201.4 67 09/21/2022
6.0.0-preview.2.21154.6 35 09/23/2022
6.0.0-preview.1.21102.12 123 09/24/2022
5.0.0 12,119 06/27/2022
5.0.0-rc.2.20475.5 48 10/15/2022
5.0.0-rc.1.20451.14 46 09/22/2022
5.0.0-preview.8.20407.11 28 09/27/2022
5.0.0-preview.7.20364.11 45 10/15/2022
5.0.0-preview.6.20305.6 50 09/26/2022
5.0.0-preview.5.20278.1 61 09/22/2022
5.0.0-preview.4.20251.6 44 10/15/2022
5.0.0-preview.3.20214.6 95 09/25/2022
5.0.0-preview.2.20160.6 32 10/15/2022
5.0.0-preview.1.20120.5 44 09/25/2022
1.7.1 10,391 06/27/2022
1.7.0 12,869 09/24/2022
1.7.0-preview3.19551.4 86 09/22/2022
1.7.0-preview2.19523.17 115 09/21/2022
1.7.0-preview1.19504.10 60 09/21/2022
1.6.0 55 09/21/2022
1.6.0-rc1.19456.4 45 09/22/2022
1.6.0-preview9.19421.4 45 09/21/2022
1.6.0-preview9.19416.11 88 10/15/2022
1.6.0-preview8.19405.3 19 09/21/2022
1.6.0-preview7.19362.9 129 09/25/2022
1.6.0-preview6.19303.8 93 09/25/2022
1.6.0-preview6.19264.9 35 09/22/2022
1.6.0-preview5.19224.8 79 10/15/2022
1.6.0-preview4.19212.13 44 09/21/2022
1.6.0-preview3.19128.7 39 09/23/2022
1.6.0-preview.19073.11 123 09/21/2022
1.6.0-preview.18571.3 75 10/15/2022
1.5.0 23 09/21/2022
1.5.0-rc1 109 09/21/2022
1.5.0-preview2-26406-04 98 09/21/2022
1.5.0-preview1-26216-02 97 09/21/2022
1.4.0 61 09/22/2022
1.4.0-preview2-25405-01 38 09/22/2022
1.4.0-preview1-25305-02 37 09/24/2022
1.3.1 33 09/23/2022
1.3.0 3,952 06/27/2022
1.3.0-preview1-24530-04 30 09/21/2022
1.2.0 28 06/27/2022
1.2.0-rc2-24027 83 09/21/2022
1.1.38-beta-23516 46 09/21/2022
1.1.38-beta-23409 63 09/24/2022
1.1.38-beta-23225 38 09/21/2022
1.1.37 76 09/23/2022
1.1.37-beta-23109 117 09/22/2022
1.1.37-beta-23019 41 09/22/2022
1.1.36 104 06/27/2022
1.1.34-rc 51 08/29/2022
1.1.33-beta 45 09/11/2022
1.1.32-beta 90 09/11/2022