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

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.1.24431.7 11,995 9/10/2024
9.0.0-preview.7.24405.7 28,307 8/13/2024
9.0.0-preview.6.24327.7 41,938 7/9/2024
9.0.0-preview.5.24306.7 37,118 6/11/2024
9.0.0-preview.4.24266.19 33,075 5/21/2024
9.0.0-preview.3.24172.9 118,284 4/11/2024
9.0.0-preview.2.24128.5 40,279 3/12/2024
9.0.0-preview.1.24080.9 75,428 2/13/2024
8.0.0 77,569,496 11/14/2023
8.0.0-rc.2.23479.6 271,648 10/10/2023
8.0.0-rc.1.23419.4 223,488 9/12/2023
8.0.0-preview.7.23375.6 140,066 8/8/2023
8.0.0-preview.6.23329.7 116,900 7/11/2023
8.0.0-preview.5.23280.8 94,888 6/13/2023
8.0.0-preview.4.23259.5 242,035 5/16/2023
8.0.0-preview.3.23174.8 191,274 4/11/2023
8.0.0-preview.2.23128.3 71,436 3/14/2023
8.0.0-preview.1.23110.8 142,486 2/21/2023
7.0.0 110,497,117 11/7/2022
7.0.0-rc.2.22472.3 206,379 10/11/2022
7.0.0-rc.1.22426.10 150,708 9/14/2022
7.0.0-preview.7.22375.6 206,936 8/9/2022
7.0.0-preview.6.22324.4 102,111 7/12/2022
7.0.0-preview.5.22301.12 71,842 6/14/2022
7.0.0-preview.4.22229.4 109,214 5/10/2022
7.0.0-preview.3.22175.4 65,319 4/13/2022
7.0.0-preview.2.22152.2 60,240 3/14/2022
7.0.0-preview.1.22076.8 50,198 2/17/2022
6.0.0 262,132,119 11/8/2021
6.0.0-rc.2.21480.5 545,537 10/12/2021
6.0.0-rc.1.21451.13 370,039 9/14/2021
6.0.0-preview.7.21377.19 211,100 8/10/2021
6.0.0-preview.6.21352.12 130,367 7/14/2021
6.0.0-preview.5.21301.5 78,903 6/15/2021
6.0.0-preview.4.21253.7 59,728 5/24/2021
6.0.0-preview.3.21201.4 203,501 4/8/2021
6.0.0-preview.2.21154.6 122,592 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 134,829 2/12/2021 6.0.0-preview.1.21102.12 is deprecated because it is no longer maintained.
5.0.0 171,052,674 11/9/2020 5.0.0 is deprecated because it is no longer maintained.
5.0.0-rc.2.20475.5 258,976 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 347,637 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,258 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,061 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,371 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 268,124 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 123,277 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,029 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,097 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,717 3/16/2020 5.0.0-preview.1.20120.4 is deprecated because it is no longer maintained.
3.1.32 2,553,503 12/13/2022
3.1.31 784,649 11/8/2022
3.1.30 1,568,574 10/11/2022
3.1.29 712,563 9/13/2022
3.1.28 602,857 8/9/2022
3.1.27 583,617 7/12/2022
3.1.26 491,796 6/14/2022
3.1.25 858,815 5/10/2022
3.1.24 9,586,490 4/11/2022
3.1.23 2,847,069 3/8/2022
3.1.22 11,946,719 12/14/2021
3.1.21 4,346,483 11/7/2021
3.1.20 2,082,742 10/11/2021
3.1.19 1,991,604 9/14/2021
3.1.18 3,733,772 8/10/2021
3.1.17 3,196,914 7/13/2021
3.1.16 3,522,540 6/8/2021
3.1.15 3,981,101 5/11/2021
3.1.14 5,886,263 4/6/2021
3.1.13 6,658,078 3/9/2021
3.1.12 4,709,040 2/9/2021
3.1.11 6,013,764 1/12/2021
3.1.10 13,665,371 11/9/2020
3.1.9 15,528,599 10/13/2020
3.1.8 20,696,368 9/8/2020
3.1.7 13,822,934 8/11/2020
3.1.6 22,026,772 7/14/2020
3.1.5 23,309,154 6/9/2020
3.1.4 14,481,413 5/12/2020
3.1.3 24,316,541 3/24/2020
3.1.2 20,336,638 2/18/2020
3.1.1 16,120,509 1/14/2020
3.1.0 129,607,597 12/3/2019
3.1.0-preview3.19553.2 91,358 11/13/2019 3.1.0-preview3.19553.2 is deprecated because it is no longer maintained.
3.1.0-preview2.19525.4 20,610 11/1/2019 3.1.0-preview2.19525.4 is deprecated because it is no longer maintained.
3.1.0-preview1.19506.1 48,147 10/15/2019 3.1.0-preview1.19506.1 is deprecated because it is no longer maintained.
3.0.3 675,637 2/18/2020 3.0.3 is deprecated because it is no longer maintained.
3.0.2 815,916 1/14/2020 3.0.2 is deprecated because it is no longer maintained.
3.0.1 2,817,989 11/18/2019 3.0.1 is deprecated because it is no longer maintained.
3.0.0 29,002,460 9/23/2019 3.0.0 is deprecated because it is no longer maintained.
3.0.0-rc1.19456.10 45,474 9/16/2019 3.0.0-rc1.19456.10 is deprecated because it is no longer maintained.
3.0.0-preview9.19423.4 244,822 9/4/2019 3.0.0-preview9.19423.4 is deprecated because it is no longer maintained.
3.0.0-preview8.19405.4 231,193 8/13/2019 3.0.0-preview8.19405.4 is deprecated because it is no longer maintained.
3.0.0-preview7.19362.4 222,142 7/23/2019 3.0.0-preview7.19362.4 is deprecated because it is no longer maintained.
3.0.0-preview6.19304.6 575,305 6/12/2019 3.0.0-preview6.19304.6 is deprecated because it is no longer maintained.
3.0.0-preview5.19227.9 219,571 5/6/2019 3.0.0-preview5.19227.9 is deprecated because it is no longer maintained.
3.0.0-preview4.19216.2 38,606 4/18/2019 3.0.0-preview4.19216.2 is deprecated because it is no longer maintained.
3.0.0-preview3.19153.1 196,345 3/6/2019 3.0.0-preview3.19153.1 is deprecated because it is no longer maintained.
3.0.0-preview.19074.2 130,733 1/29/2019 3.0.0-preview.19074.2 is deprecated because it is no longer maintained.
3.0.0-preview.18572.1 45,901 12/4/2018 3.0.0-preview.18572.1 is deprecated because it is no longer maintained.
2.2.0 195,980,178 12/3/2018 2.2.0 is deprecated because it is no longer maintained.
2.2.0-preview3-35497 298,867 10/17/2018 2.2.0-preview3-35497 is deprecated because it is no longer maintained.
2.2.0-preview2-35157 152,469 9/12/2018 2.2.0-preview2-35157 is deprecated because it is no longer maintained.
2.2.0-preview1-35029 82,442 8/22/2018 2.2.0-preview1-35029 is deprecated because it is no longer maintained.
2.1.1 216,124,823 6/18/2018
2.1.0 239,628,749 5/29/2018
2.1.0-rc1-final 303,895 5/6/2018 2.1.0-rc1-final is deprecated because it is no longer maintained.
2.1.0-preview2-final 403,283 4/10/2018 2.1.0-preview2-final is deprecated because it is no longer maintained.
2.1.0-preview1-final 1,671,369 2/26/2018 2.1.0-preview1-final is deprecated because it is no longer maintained.
2.0.1 35,411,230 3/13/2018 2.0.1 is deprecated because it is no longer maintained.
2.0.0 82,706,046 8/11/2017 2.0.0 is deprecated because it is no longer maintained.
2.0.0-preview2-final 458,654 6/28/2017 2.0.0-preview2-final is deprecated because it is no longer maintained.
2.0.0-preview1-final 191,012 5/10/2017 2.0.0-preview1-final is deprecated because it is no longer maintained.
1.1.1 21,475,582 5/9/2017 1.1.1 is deprecated because it is no longer maintained.
1.1.0 15,036,250 11/16/2016 1.1.0 is deprecated because it is no longer maintained.
1.1.0-preview1-final 68,065 10/24/2016 1.1.0-preview1-final is deprecated because it is no longer maintained.
1.0.1 91,016,193 12/12/2016 1.0.1 is deprecated because it is no longer maintained.
1.0.0 20,393,297 6/27/2016 1.0.0 is deprecated because it is no longer maintained.
1.0.0-rc2-final 1,879,360 5/16/2016 1.0.0-rc2-final is deprecated because it is no longer maintained.