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.Hosting
Hosting and startup infrastructures for applications.
1,055
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,052
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
1,051
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
910
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
900
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
855
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.
846
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
468
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
267
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
214
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.
135
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
134
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
134
Microsoft.Extensions.Configuration.UserSecrets
User secrets configuration provider implementation for Microsoft.Extensions.Configuration.
134
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
123
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.
123
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
17
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
12
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
12

Version Downloads Last updated
11.0.0-preview.2.26159.112 0 03/10/2026
11.0.0-preview.1.26104.118 0 02/10/2026
10.0.5 10 03/30/2026
10.0.4 0 03/10/2026
10.0.3 0 02/10/2026
10.0.2 910 02/03/2026
10.0.1 0 12/09/2025
10.0.0 466 02/03/2026
10.0.0-rc.2.25502.107 0 10/14/2025
10.0.0-rc.1.25451.107 1 10/06/2025
10.0.0-preview.7.25380.108 0 08/12/2025
10.0.0-preview.6.25358.103 0 07/15/2025
10.0.0-preview.5.25277.114 0 06/06/2025
10.0.0-preview.4.25258.110 0 05/12/2025
10.0.0-preview.3.25171.5 0 04/10/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.14 0 03/10/2026
9.0.13 0 02/10/2026
9.0.12 0 01/13/2026
9.0.11 0 11/11/2025
9.0.10 0 10/14/2025
9.0.9 12 10/07/2025
9.0.8 0 08/04/2025
9.0.7 0 07/08/2025
9.0.6 0 06/10/2025
9.0.5 1,050 10/03/2025
9.0.4 0 04/08/2025
9.0.3 17 10/06/2025
9.0.2 0 02/11/2025
9.0.1 0 01/14/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 0 09/10/2024
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 1,115 10/03/2025
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 134 10/09/2025
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 3 10/20/2025
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 267 10/09/2025
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 7 10/09/2025
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