Microsoft.Extensions.FileProviders.Physical 8.0.0

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Microsoft.Extensions.FileProviders.Physical --version 8.0.0                
NuGet\Install-Package Microsoft.Extensions.FileProviders.Physical -Version 8.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Microsoft.Extensions.FileProviders.Physical" Version="8.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Microsoft.Extensions.FileProviders.Physical --version 8.0.0                
#r "nuget: Microsoft.Extensions.FileProviders.Physical, 8.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Microsoft.Extensions.FileProviders.Physical as a Cake Addin
#addin nuget:?package=Microsoft.Extensions.FileProviders.Physical&version=8.0.0

// Install Microsoft.Extensions.FileProviders.Physical as a Cake Tool
#tool nuget:?package=Microsoft.Extensions.FileProviders.Physical&version=8.0.0                

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.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (340)

Showing the top 5 NuGet packages that depend on Microsoft.Extensions.FileProviders.Physical:

Package 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.

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.

Microsoft.Extensions.Hosting

Hosting and startup infrastructures for applications.

Microsoft.AspNetCore.Hosting

ASP.NET Core hosting infrastructure and startup logic for web applications. This package was built from the source code at https://github.com/aspnet/AspNetCore/tree/be0a4a7f4cf06cbd6ec714bd1d9afee6bdb040a8

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

GitHub repositories (86)

Showing the top 5 popular GitHub repositories that depend on Microsoft.Extensions.FileProviders.Physical:

Repository Stars
BeyondDimension/SteamTools
🛠「Watt Toolkit」是一个开源跨平台的多功能 Steam 工具箱。
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
chocolatey/choco
Chocolatey - the package manager for Windows
JeffreySu/WeiXinMPSDK
微信全平台 .NET SDK, Senparc.Weixin for C#,支持 .NET Framework 及 .NET Core、.NET 8.0。已支持微信公众号、小程序、小游戏、微信支付、企业微信/企业号、开放平台、JSSDK、微信周边等全平台。 WeChat SDK for C#.
RayWangQvQ/BiliBiliToolPro
B 站(bilibili)自动任务工具,支持docker、青龙、k8s等多种部署方式。敏感肌也能用。
Version Downloads Last updated
9.0.0-rc.2.24473.5 52,413 10/8/2024
9.0.0-rc.1.24431.7 66,057 9/10/2024
9.0.0-preview.7.24405.7 43,879 8/13/2024
9.0.0-preview.6.24327.7 51,649 7/9/2024
9.0.0-preview.5.24306.7 43,722 6/11/2024
9.0.0-preview.4.24266.19 39,423 5/21/2024
9.0.0-preview.3.24172.9 136,379 4/11/2024
9.0.0-preview.2.24128.5 45,852 3/12/2024
9.0.0-preview.1.24080.9 79,519 2/13/2024
8.0.0 100,567,255 11/14/2023
8.0.0-rc.2.23479.6 284,784 10/10/2023
8.0.0-rc.1.23419.4 239,842 9/12/2023
8.0.0-preview.7.23375.6 144,820 8/8/2023
8.0.0-preview.6.23329.7 120,435 7/11/2023
8.0.0-preview.5.23280.8 101,130 6/13/2023
8.0.0-preview.4.23259.5 262,899 5/16/2023
8.0.0-preview.3.23174.8 205,797 4/11/2023
8.0.0-preview.2.23128.3 74,893 3/14/2023
8.0.0-preview.1.23110.8 145,043 2/21/2023
7.0.0 116,457,517 11/7/2022
7.0.0-rc.2.22472.3 210,844 10/11/2022
7.0.0-rc.1.22426.10 154,848 9/14/2022
7.0.0-preview.7.22375.6 208,655 8/9/2022
7.0.0-preview.6.22324.4 105,181 7/12/2022
7.0.0-preview.5.22301.12 73,153 6/14/2022
7.0.0-preview.4.22229.4 111,044 5/10/2022
7.0.0-preview.3.22175.4 66,954 4/13/2022
7.0.0-preview.2.22152.2 61,328 3/14/2022
7.0.0-preview.1.22076.8 50,707 2/17/2022
6.0.0 274,122,164 11/8/2021
6.0.0-rc.2.21480.5 552,944 10/12/2021
6.0.0-rc.1.21451.13 372,627 9/14/2021
6.0.0-preview.7.21377.19 215,136 8/10/2021
6.0.0-preview.6.21352.12 131,369 7/14/2021
6.0.0-preview.5.21301.5 79,958 6/15/2021
6.0.0-preview.4.21253.7 59,981 5/24/2021
6.0.0-preview.3.21201.4 205,781 4/8/2021
6.0.0-preview.2.21154.6 124,858 3/11/2021 6.0.0-preview.2.21154.6 is deprecated because it is no longer maintained.
6.0.0-preview.1.21102.12 138,229 2/12/2021 6.0.0-preview.1.21102.12 is deprecated because it is no longer maintained.
5.0.0 177,673,486 11/9/2020 5.0.0 is deprecated because it is no longer maintained.
5.0.0-rc.2.20475.5 262,846 10/13/2020 5.0.0-rc.2.20475.5 is deprecated because it is no longer maintained.
5.0.0-rc.1.20451.14 348,531 9/14/2020 5.0.0-rc.1.20451.14 is deprecated because it is no longer maintained.
5.0.0-preview.8.20407.11 73,998 8/25/2020 5.0.0-preview.8.20407.11 is deprecated because it is no longer maintained.
5.0.0-preview.7.20364.11 135,545 7/21/2020 5.0.0-preview.7.20364.11 is deprecated because it is no longer maintained.
5.0.0-preview.6.20305.6 59,831 6/25/2020 5.0.0-preview.6.20305.6 is deprecated because it is no longer maintained.
5.0.0-preview.5.20278.1 296,001 6/10/2020 5.0.0-preview.5.20278.1 is deprecated because it is no longer maintained.
5.0.0-preview.4.20251.6 124,413 5/18/2020 5.0.0-preview.4.20251.6 is deprecated because it is no longer maintained.
5.0.0-preview.3.20215.2 48,650 4/23/2020 5.0.0-preview.3.20215.2 is deprecated because it is no longer maintained.
5.0.0-preview.2.20160.3 125,841 4/2/2020 5.0.0-preview.2.20160.3 is deprecated because it is no longer maintained.
5.0.0-preview.1.20120.4 60,953 3/16/2020 5.0.0-preview.1.20120.4 is deprecated because it is no longer maintained.
3.1.32 2,808,537 12/13/2022
3.1.31 833,646 11/8/2022
3.1.30 1,670,702 10/11/2022
3.1.29 774,413 9/13/2022
3.1.28 621,482 8/9/2022
3.1.27 591,773 7/12/2022
3.1.26 502,080 6/14/2022
3.1.25 884,011 5/10/2022
3.1.24 10,183,945 4/11/2022
3.1.23 2,909,352 3/8/2022
3.1.22 12,532,986 12/14/2021
3.1.21 4,409,573 11/7/2021
3.1.20 2,116,359 10/11/2021
3.1.19 2,010,524 9/14/2021
3.1.18 3,783,820 8/10/2021
3.1.17 3,232,736 7/13/2021
3.1.16 3,560,724 6/8/2021
3.1.15 4,041,516 5/11/2021
3.1.14 5,973,516 4/6/2021
3.1.13 6,761,946 3/9/2021
3.1.12 4,774,959 2/9/2021
3.1.11 6,137,863 1/12/2021
3.1.10 13,832,191 11/9/2020
3.1.9 15,761,808 10/13/2020
3.1.8 20,982,453 9/8/2020
3.1.7 14,017,820 8/11/2020
3.1.6 22,553,129 7/14/2020
3.1.5 23,676,575 6/9/2020
3.1.4 14,770,177 5/12/2020
3.1.3 24,737,707 3/24/2020
3.1.2 20,657,145 2/18/2020
3.1.1 16,373,540 1/14/2020
3.1.0 139,073,906 12/3/2019
3.1.0-preview3.19553.2 93,667 11/13/2019 3.1.0-preview3.19553.2 is deprecated because it is no longer maintained.
3.1.0-preview2.19525.4 20,671 11/1/2019 3.1.0-preview2.19525.4 is deprecated because it is no longer maintained.
3.1.0-preview1.19506.1 48,394 10/15/2019 3.1.0-preview1.19506.1 is deprecated because it is no longer maintained.
3.0.3 691,350 2/18/2020 3.0.3 is deprecated because it is no longer maintained.
3.0.2 817,413 1/14/2020 3.0.2 is deprecated because it is no longer maintained.
3.0.1 2,850,076 11/18/2019 3.0.1 is deprecated because it is no longer maintained.
3.0.0 29,619,332 9/23/2019 3.0.0 is deprecated because it is no longer maintained.
3.0.0-rc1.19456.10 45,603 9/16/2019 3.0.0-rc1.19456.10 is deprecated because it is no longer maintained.
3.0.0-preview9.19423.4 251,403 9/4/2019 3.0.0-preview9.19423.4 is deprecated because it is no longer maintained.
3.0.0-preview8.19405.4 237,870 8/13/2019 3.0.0-preview8.19405.4 is deprecated because it is no longer maintained.
3.0.0-preview7.19362.4 226,533 7/23/2019 3.0.0-preview7.19362.4 is deprecated because it is no longer maintained.
3.0.0-preview6.19304.6 592,673 6/12/2019 3.0.0-preview6.19304.6 is deprecated because it is no longer maintained.
3.0.0-preview5.19227.9 223,133 5/6/2019 3.0.0-preview5.19227.9 is deprecated because it is no longer maintained.
3.0.0-preview4.19216.2 38,936 4/18/2019 3.0.0-preview4.19216.2 is deprecated because it is no longer maintained.
3.0.0-preview3.19153.1 200,487 3/6/2019 3.0.0-preview3.19153.1 is deprecated because it is no longer maintained.
3.0.0-preview.19074.2 132,485 1/29/2019 3.0.0-preview.19074.2 is deprecated because it is no longer maintained.
3.0.0-preview.18572.1 46,418 12/4/2018 3.0.0-preview.18572.1 is deprecated because it is no longer maintained.
2.2.0 201,981,039 12/3/2018 2.2.0 is deprecated because it is no longer maintained.
2.2.0-preview3-35497 300,142 10/17/2018 2.2.0-preview3-35497 is deprecated because it is no longer maintained.
2.2.0-preview2-35157 153,364 9/12/2018 2.2.0-preview2-35157 is deprecated because it is no longer maintained.
2.2.0-preview1-35029 83,022 8/22/2018 2.2.0-preview1-35029 is deprecated because it is no longer maintained.
2.1.1 226,984,500 6/18/2018
2.1.0 246,851,132 5/29/2018
2.1.0-rc1-final 311,103 5/6/2018 2.1.0-rc1-final is deprecated because it is no longer maintained.
2.1.0-preview2-final 417,414 4/10/2018 2.1.0-preview2-final is deprecated because it is no longer maintained.
2.1.0-preview1-final 1,697,813 2/26/2018 2.1.0-preview1-final is deprecated because it is no longer maintained.
2.0.1 36,033,730 3/13/2018 2.0.1 is deprecated because it is no longer maintained.
2.0.0 84,550,429 8/11/2017 2.0.0 is deprecated because it is no longer maintained.
2.0.0-preview2-final 468,667 6/28/2017 2.0.0-preview2-final is deprecated because it is no longer maintained.
2.0.0-preview1-final 192,585 5/10/2017 2.0.0-preview1-final is deprecated because it is no longer maintained.
1.1.1 21,827,198 5/9/2017 1.1.1 is deprecated because it is no longer maintained.
1.1.0 15,176,369 11/16/2016 1.1.0 is deprecated because it is no longer maintained.
1.1.0-preview1-final 68,564 10/24/2016 1.1.0-preview1-final is deprecated because it is no longer maintained.
1.0.1 91,718,474 12/12/2016 1.0.1 is deprecated because it is no longer maintained.
1.0.0 20,604,470 6/27/2016 1.0.0 is deprecated because it is no longer maintained.
1.0.0-rc2-final 1,883,238 5/16/2016 1.0.0-rc2-final is deprecated because it is no longer maintained.