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 (338)

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 (80)

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.
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等多种部署方式。敏感肌也能用。
umbraco/Umbraco-CMS
Umbraco is a free and open source .NET content management system helping you deliver delightful digital experiences.
Version Downloads Last updated
9.0.0-preview.6.24327.7 4,612 7/9/2024
9.0.0-preview.5.24306.7 22,578 6/11/2024
9.0.0-preview.4.24266.19 22,370 5/21/2024
9.0.0-preview.3.24172.9 76,453 4/11/2024
9.0.0-preview.2.24128.5 32,020 3/12/2024
9.0.0-preview.1.24080.9 66,869 2/13/2024
8.0.0 50,976,831 11/14/2023
8.0.0-rc.2.23479.6 253,393 10/10/2023
8.0.0-rc.1.23419.4 202,863 9/12/2023
8.0.0-preview.7.23375.6 133,956 8/8/2023
8.0.0-preview.6.23329.7 111,406 7/11/2023
8.0.0-preview.5.23280.8 87,304 6/13/2023
8.0.0-preview.4.23259.5 215,163 5/16/2023
8.0.0-preview.3.23174.8 163,636 4/11/2023
8.0.0-preview.2.23128.3 65,658 3/14/2023
8.0.0-preview.1.23110.8 139,164 2/21/2023
7.0.0 102,892,660 11/7/2022
7.0.0-rc.2.22472.3 201,134 10/11/2022
7.0.0-rc.1.22426.10 146,006 9/14/2022
7.0.0-preview.7.22375.6 204,696 8/9/2022
7.0.0-preview.6.22324.4 96,829 7/12/2022
7.0.0-preview.5.22301.12 70,075 6/14/2022
7.0.0-preview.4.22229.4 106,702 5/10/2022
7.0.0-preview.3.22175.4 62,896 4/13/2022
7.0.0-preview.2.22152.2 58,564 3/14/2022
7.0.0-preview.1.22076.8 49,355 2/17/2022
6.0.0 246,458,613 11/8/2021
6.0.0-rc.2.21480.5 538,349 10/12/2021
6.0.0-rc.1.21451.13 366,597 9/14/2021
6.0.0-preview.7.21377.19 209,404 8/10/2021
6.0.0-preview.6.21352.12 128,729 7/14/2021
6.0.0-preview.5.21301.5 77,706 6/15/2021
6.0.0-preview.4.21253.7 59,259 5/24/2021
6.0.0-preview.3.21201.4 199,418 4/8/2021
6.0.0-preview.2.21154.6 119,887 3/11/2021
6.0.0-preview.1.21102.12 130,878 2/12/2021
5.0.0 163,539,412 11/9/2020
5.0.0-rc.2.20475.5 253,619 10/13/2020
5.0.0-rc.1.20451.14 346,591 9/14/2020
5.0.0-preview.8.20407.11 72,259 8/25/2020
5.0.0-preview.7.20364.11 134,402 7/21/2020
5.0.0-preview.6.20305.6 58,721 6/25/2020
5.0.0-preview.5.20278.1 249,501 6/10/2020
5.0.0-preview.4.20251.6 121,920 5/18/2020
5.0.0-preview.3.20215.2 47,283 4/23/2020
5.0.0-preview.2.20160.3 124,165 4/2/2020
5.0.0-preview.1.20120.4 60,285 3/16/2020
3.1.32 2,233,442 12/13/2022
3.1.31 721,126 11/8/2022
3.1.30 1,446,549 10/11/2022
3.1.29 632,005 9/13/2022
3.1.28 570,460 8/9/2022
3.1.27 569,981 7/12/2022
3.1.26 478,358 6/14/2022
3.1.25 818,898 5/10/2022
3.1.24 8,784,091 4/11/2022
3.1.23 2,746,124 3/8/2022
3.1.22 11,217,974 12/14/2021
3.1.21 4,240,341 11/7/2021
3.1.20 2,035,948 10/11/2021
3.1.19 1,961,242 9/14/2021
3.1.18 3,657,589 8/10/2021
3.1.17 3,150,839 7/13/2021
3.1.16 3,467,676 6/8/2021
3.1.15 3,905,168 5/11/2021
3.1.14 5,761,771 4/6/2021
3.1.13 6,534,178 3/9/2021
3.1.12 4,619,919 2/9/2021
3.1.11 5,843,344 1/12/2021
3.1.10 13,455,644 11/9/2020
3.1.9 15,228,635 10/13/2020
3.1.8 20,372,558 9/8/2020
3.1.7 13,585,039 8/11/2020
3.1.6 21,674,221 7/14/2020
3.1.5 22,983,284 6/9/2020
3.1.4 14,133,008 5/12/2020
3.1.3 23,823,508 3/24/2020
3.1.2 20,082,470 2/18/2020
3.1.1 15,778,761 1/14/2020
3.1.0 117,711,891 12/3/2019
3.1.0-preview3.19553.2 90,655 11/13/2019
3.1.0-preview2.19525.4 20,487 11/1/2019
3.1.0-preview1.19506.1 47,841 10/15/2019
3.0.3 652,217 2/18/2020
3.0.2 814,479 1/14/2020
3.0.1 2,775,658 11/18/2019
3.0.0 28,305,691 9/23/2019
3.0.0-rc1.19456.10 45,292 9/16/2019
3.0.0-preview9.19423.4 244,514 9/4/2019
3.0.0-preview8.19405.4 229,335 8/13/2019
3.0.0-preview7.19362.4 221,876 7/23/2019
3.0.0-preview6.19304.6 574,631 6/12/2019
3.0.0-preview5.19227.9 218,340 5/6/2019
3.0.0-preview4.19216.2 38,142 4/18/2019
3.0.0-preview3.19153.1 195,680 3/6/2019
3.0.0-preview.19074.2 129,691 1/29/2019
3.0.0-preview.18572.1 45,286 12/4/2018
2.2.0 188,471,626 12/3/2018
2.2.0-preview3-35497 297,946 10/17/2018
2.2.0-preview2-35157 151,581 9/12/2018
2.2.0-preview1-35029 81,702 8/22/2018
2.1.1 202,306,167 6/18/2018
2.1.0 229,993,172 5/29/2018
2.1.0-rc1-final 303,388 5/6/2018
2.1.0-preview2-final 402,600 4/10/2018
2.1.0-preview1-final 1,641,034 2/26/2018
2.0.1 34,530,389 3/13/2018
2.0.0 80,289,696 8/11/2017
2.0.0-preview2-final 446,644 6/28/2017
2.0.0-preview1-final 189,488 5/10/2017
1.1.1 21,179,438 5/9/2017
1.1.0 14,869,423 11/16/2016
1.1.0-preview1-final 67,963 10/24/2016
1.0.1 90,087,333 12/12/2016
1.0.0 20,021,243 6/27/2016
1.0.0-rc2-final 1,877,301 5/16/2016