Microsoft.Extensions.FileProviders.Physical 10.0.0-preview.3.25171.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.
2
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
2
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications. When using NuGet 3.x this package requires at least version 3.4.
1
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
1
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/ffaea14b06ea8b247fa4894b7d21ecf6da2cafbc
1
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/704f7cb1d2cea33afb00c2097731216f121c2c73
1
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.
1
Microsoft.Extensions.Hosting
.NET Core hosting and startup infrastructures for applications.
1

.NET Framework 4.6.2

.NET 8.0

.NET 9.0

.NET 10.0

.NET Standard 2.0

Version Downloads Last updated
10.0.0-preview.3.25171.5 1 04/25/2025
10.0.0-preview.2.25163.2 0 03/18/2025
10.0.0-preview.1.25080.5 0 02/25/2025
9.0.4 1 04/25/2025
9.0.3 0 03/11/2025
9.0.2 0 02/11/2025
9.0.1 2 04/25/2025
9.0.0 0 11/12/2024
9.0.0-rc.2.24473.5 0 10/08/2024
9.0.0-rc.1.24431.7 1 04/25/2025
9.0.0-preview.7.24405.7 0 08/13/2024
9.0.0-preview.6.24327.7 0 07/09/2024
9.0.0-preview.5.24306.7 0 06/11/2024
9.0.0-preview.4.24266.19 0 05/21/2024
9.0.0-preview.3.24172.9 0 04/11/2024
9.0.0-preview.2.24128.5 0 03/12/2024
9.0.0-preview.1.24080.9 0 02/13/2024
8.0.0 0 11/14/2023
8.0.0-rc.2.23479.6 0 10/10/2023
8.0.0-rc.1.23419.4 0 09/12/2023
8.0.0-preview.7.23375.6 0 08/08/2023
8.0.0-preview.6.23329.7 0 07/11/2023
8.0.0-preview.5.23280.8 0 06/13/2023
8.0.0-preview.4.23259.5 0 05/16/2023
8.0.0-preview.3.23174.8 0 04/11/2023
8.0.0-preview.2.23128.3 0 03/14/2023
8.0.0-preview.1.23110.8 0 02/21/2023
7.0.0 0 11/07/2022
7.0.0-rc.2.22472.3 0 10/11/2022
7.0.0-rc.1.22426.10 0 09/14/2022
7.0.0-preview.7.22375.6 0 08/09/2022
7.0.0-preview.6.22324.4 0 07/12/2022
7.0.0-preview.5.22301.12 0 06/14/2022
7.0.0-preview.4.22229.4 0 05/10/2022
7.0.0-preview.3.22175.4 0 04/13/2022
7.0.0-preview.2.22152.2 0 03/14/2022
7.0.0-preview.1.22076.8 0 02/17/2022
6.0.1 0 11/12/2024
6.0.0 0 11/08/2021
6.0.0-rc.2.21480.5 0 10/12/2021
6.0.0-rc.1.21451.13 0 09/14/2021
6.0.0-preview.7.21377.19 0 08/10/2021
6.0.0-preview.6.21352.12 0 07/14/2021
6.0.0-preview.5.21301.5 0 06/15/2021
6.0.0-preview.4.21253.7 0 05/24/2021
6.0.0-preview.3.21201.4 0 04/08/2021
6.0.0-preview.2.21154.6 0 03/11/2021
6.0.0-preview.1.21102.12 0 02/12/2021
5.0.0 0 11/09/2020
5.0.0-rc.2.20475.5 0 10/13/2020
5.0.0-rc.1.20451.14 0 09/14/2020
5.0.0-preview.8.20407.11 0 08/25/2020
5.0.0-preview.7.20364.11 0 07/21/2020
5.0.0-preview.6.20305.6 0 06/25/2020
5.0.0-preview.5.20278.1 0 06/10/2020
5.0.0-preview.4.20251.6 0 05/18/2020
5.0.0-preview.3.20215.2 0 04/23/2020
5.0.0-preview.2.20160.3 0 04/02/2020
5.0.0-preview.1.20120.4 0 03/16/2020
3.1.32 0 12/13/2022
3.1.31 0 11/08/2022
3.1.30 0 10/11/2022
3.1.29 0 09/13/2022
3.1.28 0 08/09/2022
3.1.27 0 07/12/2022
3.1.26 0 06/14/2022
3.1.25 0 05/10/2022
3.1.24 0 04/11/2022
3.1.23 0 03/08/2022
3.1.22 0 12/14/2021
3.1.21 0 11/07/2021
3.1.20 0 10/11/2021
3.1.19 0 09/14/2021
3.1.18 0 08/10/2021
3.1.17 0 07/13/2021
3.1.16 0 06/08/2021
3.1.15 0 05/11/2021
3.1.14 0 04/06/2021
3.1.13 0 03/09/2021
3.1.12 0 02/09/2021
3.1.11 0 01/12/2021
3.1.10 0 11/09/2020
3.1.9 0 10/13/2020
3.1.8 0 09/08/2020
3.1.7 0 08/11/2020
3.1.6 0 07/14/2020
3.1.5 0 06/09/2020
3.1.4 0 05/12/2020
3.1.3 0 03/24/2020
3.1.2 0 02/18/2020
3.1.1 0 01/14/2020
3.1.0 0 12/03/2019
3.1.0-preview3.19553.2 0 11/13/2019
3.1.0-preview2.19525.4 0 11/01/2019
3.1.0-preview1.19506.1 0 10/15/2019
3.0.3 0 02/18/2020
3.0.2 0 01/14/2020
3.0.1 0 11/18/2019
3.0.0 0 09/23/2019
3.0.0-rc1.19456.10 0 09/16/2019
3.0.0-preview9.19423.4 0 09/04/2019
3.0.0-preview8.19405.4 0 08/13/2019
3.0.0-preview7.19362.4 0 07/23/2019
3.0.0-preview6.19304.6 0 06/12/2019
3.0.0-preview5.19227.9 0 05/06/2019
3.0.0-preview4.19216.2 0 04/18/2019
3.0.0-preview3.19153.1 0 03/06/2019
3.0.0-preview.19074.2 0 01/29/2019
3.0.0-preview.18572.1 0 12/04/2018
2.2.0 0 12/03/2018
2.2.0-preview3-35497 0 10/17/2018
2.2.0-preview2-35157 0 09/12/2018
2.2.0-preview1-35029 0 08/22/2018
2.1.1 0 06/18/2018
2.1.0 0 05/29/2018
2.1.0-rc1-final 0 05/06/2018
2.1.0-preview2-final 0 04/10/2018
2.1.0-preview1-final 0 02/26/2018
2.0.1 0 03/13/2018
2.0.0 0 08/11/2017
2.0.0-preview2-final 0 06/28/2017
2.0.0-preview1-final 0 05/10/2017
1.1.1 0 05/09/2017
1.1.0 0 11/16/2016
1.1.0-preview1-final 0 10/24/2016
1.0.1 0 12/12/2016
1.0.0 0 06/27/2016
1.0.0-rc2-final 0 05/16/2016