Microsoft.Extensions.FileProviders.Physical 10.0.5

About

Provides an implementation of a physical file provider, facilitating file access and monitoring on the disk. The primary type, PhysicalFileProvider, enables the lookup of files on disk and can watch for changes either via FileSystemWatcher or polling mechanisms.

Key Features

  • Easy access and monitoring of files on the disk.
  • Ability to watch for file changes either by using FileSystemWatcher or through polling.

How to Use

This library can be used to look up files on disk and monitor file changes effectively. Below is an example of how to use the PhysicalFileProvider to access files on disk and monitor changes:

using Microsoft.Extensions.FileProviders;
using Microsoft.Extensions.FileProviders.Physical;

using var provider = new PhysicalFileProvider(AppContext.BaseDirectory);

Environment.SetEnvironmentVariable("DOTNET_USE_POLLING_FILE_WATCHER", "1");

var contents = provider.GetDirectoryContents(string.Empty);
foreach (PhysicalFileInfo fileInfo in contents)
{
    Console.WriteLine(fileInfo.PhysicalPath);
}

var changeToken = provider.Watch("*.txt");
changeToken.RegisterChangeCallback(_ => Console.WriteLine("Text file changed"), null);

Console.ReadLine();

Main Types

The main types provided by this library are:

  • Microsoft.Extensions.FileProviders.PhysicalFileProvider
  • Microsoft.Extensions.FileProviders.PhysicalDirectoryInfo
  • Microsoft.Extensions.FileProviders.PhysicalFileInfo

Additional Documentation

Feedback & Contributing

Microsoft.Extensions.FileProviders.Physical 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.FileProviders.Physical.

Packages Downloads
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
757
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
755
Microsoft.Extensions.Configuration.UserSecrets
User secrets configuration provider implementation for Microsoft.Extensions.Configuration. User secrets mechanism enables you to override application configuration settings with values stored in the local secrets file. You can use UserSecretsConfigurationExtensions.AddUserSecrets extension method on IConfigurationBuilder to add user secrets provider to the configuration builder.
754
Microsoft.Extensions.Configuration.UserSecrets
User secrets configuration provider implementation for Microsoft.Extensions.Configuration. User secrets mechanism enables you to override application configuration settings with values stored in the local secrets file. You can use UserSecretsConfigurationExtensions.AddUserSecrets extension method on IConfigurationBuilder to add user secrets provider to the configuration builder.
26
Microsoft.AspNetCore.Diagnostics
ASP.NET Core middleware for exception handling, exception display pages, and diagnostics information. Includes developer exception page middleware, exception handler middleware, runtime info middleware, status code page middleware, and welcome page middleware This package was built from the source code at https://github.com/aspnet/Diagnostics/tree/c802d5ef5fba1ba8dfbcb8c3741af2ba15e9d1aa
25
Microsoft.AspNetCore.All
Provides a default set of APIs for building an ASP.NET Core application, and also includes API for third-party integrations with ASP.NET Core. This package requires the ASP.NET Core runtime. This runtime is installed by the .NET Core SDK, or can be acquired separately using installers available at https://aka.ms/dotnet-download.
19
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/d634f2bd1ad6e319f26ff0f1d7ada5539158a19f
19
Microsoft.AspNetCore.SpaServices.Extensions
Helpers for building single-page applications on ASP.NET MVC Core. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/8486d31e24f30e3fa1809a95699a0adc16f448d7
19
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/da6e34b3e17bac8fd1f78c7e76d7ed6192514651
18
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
18
Microsoft.AspNetCore.Diagnostics
ASP.NET Core middleware for exception handling, exception display pages, and diagnostics information. Includes developer exception page middleware, exception handler middleware, runtime info middleware, status code page middleware, and welcome page middleware
18
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/dotnet/tree/fad253f51b461736dfd3cd9c15977bb7493becef
17
Microsoft.AspNetCore.Diagnostics
ASP.NET Core middleware for exception handling, exception display pages, and diagnostics information. Includes developer exception page middleware, exception handler middleware, runtime info middleware, status code page middleware, and welcome page middleware
17
Microsoft.AspNetCore.SpaServices.Extensions
Helpers for building single-page applications on ASP.NET MVC Core. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/4e7d976438b0fc17f435804e801d5d68d193ec33
17
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
17
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
16
Microsoft.Extensions.Configuration.UserSecrets
User secrets configuration provider implementation for Microsoft.Extensions.Configuration.
16
Microsoft.AspNetCore.SpaServices.Extensions
Helpers for building single-page applications on ASP.NET MVC Core. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/fe4f0d09305ca73aa19976b4521e5c4e223b080e
16
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/63d1187a01b82719c2891cecc74ee3d51ce892a8
16
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/36f34b3a19eb7219142ab2035921d08e84c572c3
16

Version Downloads Last updated
11.0.0-preview.2.26159.112 8 03/11/2026
11.0.0-preview.1.26104.118 12 02/12/2026
10.0.5 7 03/14/2026
10.0.4 7 03/11/2026
10.0.3 10 02/12/2026
10.0.2 13 01/15/2026
10.0.1 22 12/10/2025
10.0.0 7 01/14/2026
10.0.0-rc.2.25502.107 14 12/14/2025
10.0.0-rc.1.25451.107 12 12/14/2025
10.0.0-preview.7.25380.108 13 12/16/2025
10.0.0-preview.6.25358.103 9 12/11/2025
10.0.0-preview.5.25277.114 11 12/10/2025
10.0.0-preview.4.25258.110 9 12/11/2025
10.0.0-preview.3.25171.5 9 12/28/2025
10.0.0-preview.2.25163.2 14 12/10/2025
10.0.0-preview.1.25080.5 10 12/15/2025
9.0.14 8 03/11/2026
9.0.13 10 02/13/2026
9.0.12 13 01/15/2026
9.0.11 12 12/15/2025
9.0.10 15 12/17/2025
9.0.9 20 12/10/2025
9.0.8 14 12/09/2025
9.0.7 10 12/12/2025
9.0.6 12 12/11/2025
9.0.5 13 12/20/2025
9.0.4 14 12/15/2025
9.0.3 12 12/14/2025
9.0.2 13 12/20/2025
9.0.1 9 12/10/2025
9.0.0 16 12/14/2025
9.0.0-rc.2.24473.5 10 12/14/2025
9.0.0-rc.1.24431.7 5 12/10/2025
9.0.0-preview.7.24405.7 5 01/06/2026
9.0.0-preview.6.24327.7 13 12/11/2025
9.0.0-preview.5.24306.7 8 12/14/2025
9.0.0-preview.4.24266.19 9 12/10/2025
9.0.0-preview.3.24172.9 15 12/21/2025
9.0.0-preview.2.24128.5 15 12/10/2025
9.0.0-preview.1.24080.9 11 12/14/2025
8.0.0 758 12/10/2025
8.0.0-rc.2.23479.6 9 12/14/2025
8.0.0-rc.1.23419.4 11 12/10/2025
8.0.0-preview.7.23375.6 6 12/13/2025
8.0.0-preview.6.23329.7 9 01/01/2026
8.0.0-preview.5.23280.8 9 12/10/2025
8.0.0-preview.4.23259.5 11 12/15/2025
8.0.0-preview.3.23174.8 5 12/12/2025
8.0.0-preview.2.23128.3 13 12/14/2025
8.0.0-preview.1.23110.8 11 12/21/2025
7.0.0 18 12/10/2025
7.0.0-rc.2.22472.3 12 12/11/2025
7.0.0-rc.1.22426.10 9 01/05/2026
7.0.0-preview.7.22375.6 9 12/22/2025
7.0.0-preview.6.22324.4 7 12/24/2025
7.0.0-preview.5.22301.12 14 01/01/2026
7.0.0-preview.4.22229.4 10 12/18/2025
7.0.0-preview.3.22175.4 8 12/24/2025
7.0.0-preview.2.22152.2 4 12/15/2025
7.0.0-preview.1.22076.8 10 12/10/2025
6.0.2-mauipre.1.22102.15 8 01/07/2026
6.0.2-mauipre.1.22054.8 10 12/12/2025
6.0.1 15 12/14/2025
6.0.0 17 12/11/2025
6.0.0-rc.2.21480.5 13 12/15/2025
6.0.0-rc.1.21451.13 9 12/19/2025
6.0.0-preview.7.21377.19 10 12/13/2025
6.0.0-preview.6.21352.12 9 12/14/2025
6.0.0-preview.5.21301.5 8 12/10/2025
6.0.0-preview.4.21253.7 7 12/14/2025
6.0.0-preview.3.21201.4 6 12/10/2025
6.0.0-preview.2.21154.6 8 12/15/2025
6.0.0-preview.1.21102.12 7 12/21/2025
5.0.0 9 12/15/2025
5.0.0-rc.2.20475.5 6 12/14/2025
5.0.0-rc.1.20451.14 7 12/10/2025
5.0.0-preview.8.20407.11 12 12/14/2025
5.0.0-preview.7.20364.11 12 12/15/2025
5.0.0-preview.6.20305.6 8 12/14/2025
5.0.0-preview.5.20278.1 10 12/14/2025
5.0.0-preview.4.20251.6 10 01/01/2026
5.0.0-preview.3.20215.2 8 12/21/2025
5.0.0-preview.2.20160.3 8 12/27/2025
5.0.0-preview.1.20120.4 8 12/15/2025
3.1.32 7 12/14/2025
3.1.31 9 12/20/2025
3.1.30 10 12/20/2025
3.1.29 14 12/20/2025
3.1.28 9 12/20/2025
3.1.27 10 12/20/2025
3.1.26 14 12/14/2025
3.1.25 11 12/20/2025
3.1.24 9 12/20/2025
3.1.23 9 12/20/2025
3.1.22 6 12/15/2025
3.1.21 13 12/20/2025
3.1.20 11 12/15/2025
3.1.19 16 12/17/2025
3.1.18 10 12/14/2025
3.1.17 9 12/20/2025
3.1.16 14 12/14/2025
3.1.15 16 12/10/2025
3.1.14 14 12/14/2025
3.1.13 12 12/20/2025
3.1.12 10 12/16/2025
3.1.11 9 12/14/2025
3.1.10 15 12/15/2025
3.1.9 10 12/14/2025
3.1.8 10 12/14/2025
3.1.7 10 12/20/2025
3.1.6 13 12/12/2025
3.1.5 14 12/14/2025
3.1.4 9 12/10/2025
3.1.3 12 12/15/2025
3.1.2 9 12/18/2025
3.1.1 8 12/14/2025
3.1.0 14 12/20/2025
3.1.0-preview3.19553.2 9 12/14/2025
3.1.0-preview2.19525.4 9 12/22/2025
3.1.0-preview1.19506.1 6 12/14/2025
3.0.3 8 12/20/2025
3.0.2 11 12/15/2025
3.0.1 9 12/20/2025
3.0.0 17 12/15/2025
3.0.0-rc1.19456.10 6 12/31/2025
3.0.0-preview9.19423.4 9 12/23/2025
3.0.0-preview8.19405.4 7 01/01/2026
3.0.0-preview7.19362.4 12 12/16/2025
3.0.0-preview6.19304.6 5 01/01/2026
3.0.0-preview5.19227.9 9 12/14/2025
3.0.0-preview4.19216.2 6 12/22/2025
3.0.0-preview3.19153.1 8 12/14/2025
3.0.0-preview.19074.2 10 12/10/2025
3.0.0-preview.18572.1 10 12/15/2025
2.2.0 7 12/15/2025
2.2.0-preview3-35497 8 01/06/2026
2.2.0-preview2-35157 8 12/21/2025
2.2.0-preview1-35029 12 12/21/2025
2.1.1 10 12/20/2025
2.1.0 8 12/15/2025
2.1.0-rc1-final 11 12/20/2025
2.1.0-preview2-final 11 12/12/2025
2.1.0-preview1-final 10 12/21/2025
2.0.1 7 12/14/2025
2.0.0 12 12/10/2025
2.0.0-preview2-final 10 12/20/2025
2.0.0-preview1-final 14 12/21/2025
1.1.1 8 12/20/2025
1.1.0 15 12/15/2025
1.1.0-preview1-final 10 12/16/2025
1.0.1 11 12/10/2025
1.0.0 11 12/20/2025
1.0.0-rc2-final 10 12/20/2025