update of local deps cache

This commit is contained in:
master
2025-11-21 06:52:58 +00:00
parent 79b8e53441
commit ca35db9ef4
786 changed files with 1749002 additions and 1740601 deletions

View File

@@ -1,45 +1,45 @@
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
<metadata>
<id>Microsoft.Extensions.FileProviders.Physical</id>
<version>10.0.0-rc.2.25502.107</version>
<authors>Microsoft</authors>
<license type="expression">MIT</license>
<licenseUrl>https://licenses.nuget.org/MIT</licenseUrl>
<icon>Icon.png</icon>
<readme>PACKAGE.md</readme>
<projectUrl>https://dot.net/</projectUrl>
<description>File provider for physical files for Microsoft.Extensions.FileProviders.</description>
<releaseNotes>https://go.microsoft.com/fwlink/?LinkID=799421</releaseNotes>
<copyright>© Microsoft Corporation. All rights reserved.</copyright>
<serviceable>true</serviceable>
<repository type="git" url="https://github.com/dotnet/dotnet" commit="89c8f6a112d37d2ea8b77821e56d170a1bccdc5a" />
<dependencies>
<group targetFramework=".NETFramework4.6.2">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework="net8.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework="net9.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework="net10.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework=".NETStandard2.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
</dependencies>
</metadata>
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
<metadata>
<id>Microsoft.Extensions.FileProviders.Physical</id>
<version>10.0.0-rc.2.25502.107</version>
<authors>Microsoft</authors>
<license type="expression">MIT</license>
<licenseUrl>https://licenses.nuget.org/MIT</licenseUrl>
<icon>Icon.png</icon>
<readme>PACKAGE.md</readme>
<projectUrl>https://dot.net/</projectUrl>
<description>File provider for physical files for Microsoft.Extensions.FileProviders.</description>
<releaseNotes>https://go.microsoft.com/fwlink/?LinkID=799421</releaseNotes>
<copyright>© Microsoft Corporation. All rights reserved.</copyright>
<serviceable>true</serviceable>
<repository type="git" url="https://github.com/dotnet/dotnet" commit="89c8f6a112d37d2ea8b77821e56d170a1bccdc5a" />
<dependencies>
<group targetFramework=".NETFramework4.6.2">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework="net8.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework="net9.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework="net10.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
<group targetFramework=".NETStandard2.0">
<dependency id="Microsoft.Extensions.FileProviders.Abstractions" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.FileSystemGlobbing" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
<dependency id="Microsoft.Extensions.Primitives" version="10.0.0-rc.2.25502.107" exclude="Build,Analyzers" />
</group>
</dependencies>
</metadata>
</package>

View File

@@ -1,70 +1,70 @@
## About
<!-- A description of the package and where one can find more documentation -->
Provides an implementation of a physical file provider, facilitating file access and monitoring on the disk. The primary type, [`PhysicalFileProvider`](https://learn.microsoft.com/dotnet/api/microsoft.extensions.fileproviders.physicalfileprovider), enables the lookup of files on disk and can watch for changes either via `FileSystemWatcher` or polling mechanisms.
## Key Features
<!-- The key features of this package -->
* 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
<!-- A compelling example on how to use this package with code, as well as any specific guidelines for when to use the package -->
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:
```c#
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 in this library -->
The main types provided by this library are:
* `Microsoft.Extensions.FileProviders.PhysicalFileProvider`
* `Microsoft.Extensions.FileProviders.PhysicalDirectoryInfo`
* `Microsoft.Extensions.FileProviders.PhysicalFileInfo`
## Additional Documentation
<!-- Links to further documentation. Remove conceptual documentation if not available for the library. -->
* [Conceptual documentation](https://learn.microsoft.com/aspnet/core/fundamentals/file-providers#physical-file-provider)
* [API documentation](https://learn.microsoft.com/dotnet/api/microsoft.extensions.fileproviders.physical)
## Related Packages
<!-- The related packages associated with this package -->
* Abstractions of files and directories: [Microsoft.Extensions.FileProviders.Abstractions](https://www.nuget.org/packages/Microsoft.Extensions.FileProviders.Abstractions/)
* File system globbing to find files matching a specified pattern: [Microsoft.Extensions.FileSystemGlobbing](https://www.nuget.org/packages/Microsoft.Extensions.FileSystemGlobbing/)
## Feedback & Contributing
<!-- How to provide feedback on this package and contribute to it -->
Microsoft.Extensions.FileProviders.Physical is released as open source under the [MIT license](https://licenses.nuget.org/MIT). Bug reports and contributions are welcome at [the GitHub repository](https://github.com/dotnet/runtime).
## About
<!-- A description of the package and where one can find more documentation -->
Provides an implementation of a physical file provider, facilitating file access and monitoring on the disk. The primary type, [`PhysicalFileProvider`](https://learn.microsoft.com/dotnet/api/microsoft.extensions.fileproviders.physicalfileprovider), enables the lookup of files on disk and can watch for changes either via `FileSystemWatcher` or polling mechanisms.
## Key Features
<!-- The key features of this package -->
* 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
<!-- A compelling example on how to use this package with code, as well as any specific guidelines for when to use the package -->
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:
```c#
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 in this library -->
The main types provided by this library are:
* `Microsoft.Extensions.FileProviders.PhysicalFileProvider`
* `Microsoft.Extensions.FileProviders.PhysicalDirectoryInfo`
* `Microsoft.Extensions.FileProviders.PhysicalFileInfo`
## Additional Documentation
<!-- Links to further documentation. Remove conceptual documentation if not available for the library. -->
* [Conceptual documentation](https://learn.microsoft.com/aspnet/core/fundamentals/file-providers#physical-file-provider)
* [API documentation](https://learn.microsoft.com/dotnet/api/microsoft.extensions.fileproviders.physical)
## Related Packages
<!-- The related packages associated with this package -->
* Abstractions of files and directories: [Microsoft.Extensions.FileProviders.Abstractions](https://www.nuget.org/packages/Microsoft.Extensions.FileProviders.Abstractions/)
* File system globbing to find files matching a specified pattern: [Microsoft.Extensions.FileSystemGlobbing](https://www.nuget.org/packages/Microsoft.Extensions.FileSystemGlobbing/)
## Feedback & Contributing
<!-- How to provide feedback on this package and contribute to it -->
Microsoft.Extensions.FileProviders.Physical is released as open source under the [MIT license](https://licenses.nuget.org/MIT). Bug reports and contributions are welcome at [the GitHub repository](https://github.com/dotnet/runtime).

View File

@@ -1,6 +1,6 @@
<Project InitialTargets="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net462">
<Target Name="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net462"
Condition="'$(SuppressTfmSupportBuildWarnings)' == ''">
<Warning Text="Microsoft.Extensions.FileProviders.Physical 10.0.0-rc.2.25502.107 doesn't support $(TargetFramework) and has not been tested with it. Consider upgrading your TargetFramework to net462 or later. You may also set &lt;SuppressTfmSupportBuildWarnings&gt;true&lt;/SuppressTfmSupportBuildWarnings&gt; in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
</Target>
</Project>
<Project InitialTargets="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net462">
<Target Name="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net462"
Condition="'$(SuppressTfmSupportBuildWarnings)' == ''">
<Warning Text="Microsoft.Extensions.FileProviders.Physical 10.0.0-rc.2.25502.107 doesn't support $(TargetFramework) and has not been tested with it. Consider upgrading your TargetFramework to net462 or later. You may also set &lt;SuppressTfmSupportBuildWarnings&gt;true&lt;/SuppressTfmSupportBuildWarnings&gt; in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
</Target>
</Project>

View File

@@ -1,6 +1,6 @@
<Project InitialTargets="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net8_0">
<Target Name="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net8_0"
Condition="'$(SuppressTfmSupportBuildWarnings)' == ''">
<Warning Text="Microsoft.Extensions.FileProviders.Physical 10.0.0-rc.2.25502.107 doesn't support $(TargetFramework) and has not been tested with it. Consider upgrading your TargetFramework to net8.0 or later. You may also set &lt;SuppressTfmSupportBuildWarnings&gt;true&lt;/SuppressTfmSupportBuildWarnings&gt; in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
</Target>
</Project>
<Project InitialTargets="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net8_0">
<Target Name="NETStandardCompatError_Microsoft_Extensions_FileProviders_Physical_net8_0"
Condition="'$(SuppressTfmSupportBuildWarnings)' == ''">
<Warning Text="Microsoft.Extensions.FileProviders.Physical 10.0.0-rc.2.25502.107 doesn't support $(TargetFramework) and has not been tested with it. Consider upgrading your TargetFramework to net8.0 or later. You may also set &lt;SuppressTfmSupportBuildWarnings&gt;true&lt;/SuppressTfmSupportBuildWarnings&gt; in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
</Target>
</Project>

View File

@@ -1,393 +1,393 @@
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.FileProviders.Physical</name>
</assembly>
<members>
<member name="T:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters">
<summary>
Specifies filtering behavior for files or directories.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Sensitive">
<summary>
Equivalent to <c>DotPrefixed | Hidden | System</c>. Exclude files and directories when the name begins with a period, or has either <see cref="F:System.IO.FileAttributes.Hidden"/> or <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.DotPrefixed">
<summary>
Exclude files and directories when the name begins with period.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Hidden">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.Hidden"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.System">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.None">
<summary>
Do not exclude any files.
</summary>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo">
<summary>
Represents a directory on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.#ctor(System.IO.DirectoryInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo"/> that wraps an instance of <see cref="T:System.IO.DirectoryInfo"/>.
</summary>
<param name="info">The directory to represent.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Length">
<summary>
Gets a value that's always -1.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.LastModified">
<summary>
Gets the time when the directory was last written to.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="true"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.CreateReadStream">
<summary>
Always throws an exception because read streams are not support on directories.
</summary>
<exception cref="T:System.InvalidOperationException">In all cases.</exception>
<returns>Never returns.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo">
<summary>
Represents a file on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.#ctor(System.IO.FileInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo"/> that wraps an instance of <see cref="T:System.IO.FileInfo"/>.
</summary>
<param name="info">The <see cref="T:System.IO.FileInfo"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Length">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.LastModified">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.CreateReadStream">
<inheritdoc />
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher">
<summary>
Watches a physical file system for changes and triggers events on
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> when files are created, change, renamed, or deleted.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that's watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that is watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
<param name="filters">Specifies which files or directories are excluded. Notifications of changes to are not raised to these.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)">
<summary>
Creates an instance of <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for all files and directories that match the
<paramref name="filter" />.
</summary>
<param name="filter">A globbing pattern for files and directories to watch.</param>
<returns>A change token for all files that match the filter.</returns>
<remarks>
Globbing patterns are relative to the root directory given in the constructor
<see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)" />. Globbing patterns
are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.
</remarks>
<exception cref="T:System.ArgumentNullException"><paramref name="filter" /> is <see langword="null"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken">
<summary>
A change token that polls for file system changes.
</summary>
<remarks>
<para>Polling occurs every 4 seconds.</para>
<para>This change token does not raise any change callbacks. Callers should watch for <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> to turn
from <see langword="false"/> to <see langword="true"/> and dispose the token after this happens.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.#ctor(System.IO.FileInfo)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" /> that polls the specified file for changes as
determined by <see cref="P:System.IO.FileSystemInfo.LastWriteTimeUtc" />.
</summary>
<param name="fileInfo">The <see cref="T:System.IO.FileInfo"/> to poll.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.ActiveChangeCallbacks">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged">
<summary>
Gets a value that indicates whether the file has changed since the change token was created.
</summary>
<remarks>
Once the file changes, this value is always <see langword="true"/>. Change tokens should not reused once expired. The caller should discard this
instance once it sees <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> is true.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.RegisterChangeCallback(System.Action{System.Object},System.Object)">
<summary>
Does not actually register callbacks.
</summary>
<param name="callback">This parameter is ignored.</param>
<param name="state">This parameter is ignored.</param>
<returns>A disposable object that no-ops when disposed.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken">
<summary>
A polling based <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> for wildcard patterns.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.#ctor(System.String,System.String)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken"/>.
</summary>
<param name="root">The root of the file system.</param>
<param name="pattern">The pattern to watch.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.ActiveChangeCallbacks">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.HasChanged">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.GetLastWriteUtc(System.String)">
<summary>
Gets the last write time of the file at the specified <paramref name="path"/>.
</summary>
<param name="path">The root relative path.</param>
<returns>The <see cref="T:System.DateTime"/> that the file was last modified.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents">
<summary>
Represents the contents of a physical file directory.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
<param name="filters">Specifies which files or directories are excluded from enumeration.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.Exists">
<inheritdoc/>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider">
<summary>
Looks up files using the on-disk file system.
</summary>
<remarks>
When the environment variable "DOTNET_USE_POLLING_FILE_WATCHER" is set to "1" or "true", calls to
<see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)" /> will use <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" />.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
<param name="filters">Specifies which files or directories are excluded.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
uses polling to determine file changes.
</summary>
<value>
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
By default, <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/> uses <see cref="T:System.IO.FileSystemWatcher"/> to listen to file change events
for <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/>. <see cref="T:System.IO.FileSystemWatcher"/> is ineffective in some scenarios such as mounted drives.
Polling is required to effectively watch for file changes.
</remarks>
<seealso cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling"/>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
actively polls for file changes.
</summary>
<value>
<see langword="true"/> if the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> returned by <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/> actively polls for file changes
(<see cref="P:Microsoft.Extensions.Primitives.IChangeToken.ActiveChangeCallbacks"/> will be <see langword="true"/>) instead of being passive.
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
<para>
This property is only effective when <see cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher"/> is set.
</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Root">
<summary>
Gets the root directory for this instance.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetFileInfo(System.String)">
<summary>
Locates a file at the given path by directly mapping path segments to physical directories.
</summary>
<param name="subpath">A path under the root directory.</param>
<returns>The file information. Caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IFileInfo.Exists"/> property.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetDirectoryContents(System.String)">
<summary>
Enumerates a directory at the given path, if any.
</summary>
<param name="subpath">A path under the root directory. Leading slashes are ignored.</param>
<returns>
The contents of the directory.
</returns>
<remarks>
<para>The caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IDirectoryContents.Exists"/> property.</para>
<para>Returns <see cref="T:Microsoft.Extensions.FileProviders.NotFoundDirectoryContents" /> if <paramref name="subpath" /> is absolute,
if the directory does not exist, or <paramref name="subpath" /> has invalid characters.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)">
<summary>
<para>Creates a <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for the specified <paramref name="filter" />.</para>
<para>Globbing patterns are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.</para>
</summary>
<param name="filter">
Filter string used to determine what files or folders to monitor. Example: **/*.cs, *.*,
subFolder/**/*.cshtml.
</param>
<returns>
An <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> that is notified when a file matching <paramref name="filter" /> is added,
modified, or deleted. Returns a <see cref="T:Microsoft.Extensions.FileProviders.NullChangeToken" /> if <paramref name="filter" /> has invalid filter
characters or if <paramref name="filter" /> is an absolute path or outside the root directory specified in the
constructor <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)" />.
</returns>
</member>
<member name="P:System.SR.Argument_InvalidOffLen">
<summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
</member>
<member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNum">
<summary>Non-negative number required.</summary>
</member>
<member name="P:System.SR.Error_FileSystemWatcherRequiredWithoutPolling">
<summary>The fileSystemWatcher parameter must be non-null when pollForChanges is false.</summary>
</member>
<member name="P:System.SR.CannotCreateStream">
<summary>Cannot create a stream for a directory.</summary>
</member>
<member name="P:System.SR.CannotModifyWhenFileWatcherInitialized">
<summary>Cannot modify {0} once file watcher has been initialized.</summary>
</member>
<member name="P:System.SR.Cryptography_HashAlgorithmNameNullOrEmpty">
<summary>The hash algorithm name cannot be null or empty.</summary>
</member>
<member name="P:System.SR.UnexpectedFileSystemInfo">
<summary>Unexpected type of FileSystemInfo</summary>
</member>
<member name="P:System.SR.FileSystemWatcher_PlatformNotSupported">
<summary>The type '{0}' is not supported on this platform, use polling instead.</summary>
</member>
</members>
</doc>
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.FileProviders.Physical</name>
</assembly>
<members>
<member name="T:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters">
<summary>
Specifies filtering behavior for files or directories.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Sensitive">
<summary>
Equivalent to <c>DotPrefixed | Hidden | System</c>. Exclude files and directories when the name begins with a period, or has either <see cref="F:System.IO.FileAttributes.Hidden"/> or <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.DotPrefixed">
<summary>
Exclude files and directories when the name begins with period.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Hidden">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.Hidden"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.System">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.None">
<summary>
Do not exclude any files.
</summary>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo">
<summary>
Represents a directory on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.#ctor(System.IO.DirectoryInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo"/> that wraps an instance of <see cref="T:System.IO.DirectoryInfo"/>.
</summary>
<param name="info">The directory to represent.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Length">
<summary>
Gets a value that's always -1.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.LastModified">
<summary>
Gets the time when the directory was last written to.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="true"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.CreateReadStream">
<summary>
Always throws an exception because read streams are not support on directories.
</summary>
<exception cref="T:System.InvalidOperationException">In all cases.</exception>
<returns>Never returns.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo">
<summary>
Represents a file on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.#ctor(System.IO.FileInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo"/> that wraps an instance of <see cref="T:System.IO.FileInfo"/>.
</summary>
<param name="info">The <see cref="T:System.IO.FileInfo"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Length">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.LastModified">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.CreateReadStream">
<inheritdoc />
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher">
<summary>
Watches a physical file system for changes and triggers events on
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> when files are created, change, renamed, or deleted.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that's watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that is watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
<param name="filters">Specifies which files or directories are excluded. Notifications of changes to are not raised to these.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)">
<summary>
Creates an instance of <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for all files and directories that match the
<paramref name="filter" />.
</summary>
<param name="filter">A globbing pattern for files and directories to watch.</param>
<returns>A change token for all files that match the filter.</returns>
<remarks>
Globbing patterns are relative to the root directory given in the constructor
<see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)" />. Globbing patterns
are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.
</remarks>
<exception cref="T:System.ArgumentNullException"><paramref name="filter" /> is <see langword="null"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken">
<summary>
A change token that polls for file system changes.
</summary>
<remarks>
<para>Polling occurs every 4 seconds.</para>
<para>This change token does not raise any change callbacks. Callers should watch for <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> to turn
from <see langword="false"/> to <see langword="true"/> and dispose the token after this happens.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.#ctor(System.IO.FileInfo)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" /> that polls the specified file for changes as
determined by <see cref="P:System.IO.FileSystemInfo.LastWriteTimeUtc" />.
</summary>
<param name="fileInfo">The <see cref="T:System.IO.FileInfo"/> to poll.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.ActiveChangeCallbacks">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged">
<summary>
Gets a value that indicates whether the file has changed since the change token was created.
</summary>
<remarks>
Once the file changes, this value is always <see langword="true"/>. Change tokens should not reused once expired. The caller should discard this
instance once it sees <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> is true.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.RegisterChangeCallback(System.Action{System.Object},System.Object)">
<summary>
Does not actually register callbacks.
</summary>
<param name="callback">This parameter is ignored.</param>
<param name="state">This parameter is ignored.</param>
<returns>A disposable object that no-ops when disposed.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken">
<summary>
A polling based <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> for wildcard patterns.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.#ctor(System.String,System.String)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken"/>.
</summary>
<param name="root">The root of the file system.</param>
<param name="pattern">The pattern to watch.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.ActiveChangeCallbacks">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.HasChanged">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.GetLastWriteUtc(System.String)">
<summary>
Gets the last write time of the file at the specified <paramref name="path"/>.
</summary>
<param name="path">The root relative path.</param>
<returns>The <see cref="T:System.DateTime"/> that the file was last modified.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents">
<summary>
Represents the contents of a physical file directory.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
<param name="filters">Specifies which files or directories are excluded from enumeration.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.Exists">
<inheritdoc/>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider">
<summary>
Looks up files using the on-disk file system.
</summary>
<remarks>
When the environment variable "DOTNET_USE_POLLING_FILE_WATCHER" is set to "1" or "true", calls to
<see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)" /> will use <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" />.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
<param name="filters">Specifies which files or directories are excluded.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
uses polling to determine file changes.
</summary>
<value>
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
By default, <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/> uses <see cref="T:System.IO.FileSystemWatcher"/> to listen to file change events
for <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/>. <see cref="T:System.IO.FileSystemWatcher"/> is ineffective in some scenarios such as mounted drives.
Polling is required to effectively watch for file changes.
</remarks>
<seealso cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling"/>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
actively polls for file changes.
</summary>
<value>
<see langword="true"/> if the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> returned by <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/> actively polls for file changes
(<see cref="P:Microsoft.Extensions.Primitives.IChangeToken.ActiveChangeCallbacks"/> will be <see langword="true"/>) instead of being passive.
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
<para>
This property is only effective when <see cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher"/> is set.
</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Root">
<summary>
Gets the root directory for this instance.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetFileInfo(System.String)">
<summary>
Locates a file at the given path by directly mapping path segments to physical directories.
</summary>
<param name="subpath">A path under the root directory.</param>
<returns>The file information. Caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IFileInfo.Exists"/> property.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetDirectoryContents(System.String)">
<summary>
Enumerates a directory at the given path, if any.
</summary>
<param name="subpath">A path under the root directory. Leading slashes are ignored.</param>
<returns>
The contents of the directory.
</returns>
<remarks>
<para>The caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IDirectoryContents.Exists"/> property.</para>
<para>Returns <see cref="T:Microsoft.Extensions.FileProviders.NotFoundDirectoryContents" /> if <paramref name="subpath" /> is absolute,
if the directory does not exist, or <paramref name="subpath" /> has invalid characters.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)">
<summary>
<para>Creates a <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for the specified <paramref name="filter" />.</para>
<para>Globbing patterns are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.</para>
</summary>
<param name="filter">
Filter string used to determine what files or folders to monitor. Example: **/*.cs, *.*,
subFolder/**/*.cshtml.
</param>
<returns>
An <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> that is notified when a file matching <paramref name="filter" /> is added,
modified, or deleted. Returns a <see cref="T:Microsoft.Extensions.FileProviders.NullChangeToken" /> if <paramref name="filter" /> has invalid filter
characters or if <paramref name="filter" /> is an absolute path or outside the root directory specified in the
constructor <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)" />.
</returns>
</member>
<member name="P:System.SR.Argument_InvalidOffLen">
<summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
</member>
<member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNum">
<summary>Non-negative number required.</summary>
</member>
<member name="P:System.SR.Error_FileSystemWatcherRequiredWithoutPolling">
<summary>The fileSystemWatcher parameter must be non-null when pollForChanges is false.</summary>
</member>
<member name="P:System.SR.CannotCreateStream">
<summary>Cannot create a stream for a directory.</summary>
</member>
<member name="P:System.SR.CannotModifyWhenFileWatcherInitialized">
<summary>Cannot modify {0} once file watcher has been initialized.</summary>
</member>
<member name="P:System.SR.Cryptography_HashAlgorithmNameNullOrEmpty">
<summary>The hash algorithm name cannot be null or empty.</summary>
</member>
<member name="P:System.SR.UnexpectedFileSystemInfo">
<summary>Unexpected type of FileSystemInfo</summary>
</member>
<member name="P:System.SR.FileSystemWatcher_PlatformNotSupported">
<summary>The type '{0}' is not supported on this platform, use polling instead.</summary>
</member>
</members>
</doc>

View File

@@ -1,393 +1,393 @@
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.FileProviders.Physical</name>
</assembly>
<members>
<member name="T:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters">
<summary>
Specifies filtering behavior for files or directories.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Sensitive">
<summary>
Equivalent to <c>DotPrefixed | Hidden | System</c>. Exclude files and directories when the name begins with a period, or has either <see cref="F:System.IO.FileAttributes.Hidden"/> or <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.DotPrefixed">
<summary>
Exclude files and directories when the name begins with period.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Hidden">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.Hidden"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.System">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.None">
<summary>
Do not exclude any files.
</summary>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo">
<summary>
Represents a directory on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.#ctor(System.IO.DirectoryInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo"/> that wraps an instance of <see cref="T:System.IO.DirectoryInfo"/>.
</summary>
<param name="info">The directory to represent.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Length">
<summary>
Gets a value that's always -1.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.LastModified">
<summary>
Gets the time when the directory was last written to.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="true"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.CreateReadStream">
<summary>
Always throws an exception because read streams are not support on directories.
</summary>
<exception cref="T:System.InvalidOperationException">In all cases.</exception>
<returns>Never returns.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo">
<summary>
Represents a file on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.#ctor(System.IO.FileInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo"/> that wraps an instance of <see cref="T:System.IO.FileInfo"/>.
</summary>
<param name="info">The <see cref="T:System.IO.FileInfo"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Length">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.LastModified">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.CreateReadStream">
<inheritdoc />
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher">
<summary>
Watches a physical file system for changes and triggers events on
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> when files are created, change, renamed, or deleted.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that's watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that is watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
<param name="filters">Specifies which files or directories are excluded. Notifications of changes to are not raised to these.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)">
<summary>
Creates an instance of <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for all files and directories that match the
<paramref name="filter" />.
</summary>
<param name="filter">A globbing pattern for files and directories to watch.</param>
<returns>A change token for all files that match the filter.</returns>
<remarks>
Globbing patterns are relative to the root directory given in the constructor
<see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)" />. Globbing patterns
are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.
</remarks>
<exception cref="T:System.ArgumentNullException"><paramref name="filter" /> is <see langword="null"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken">
<summary>
A change token that polls for file system changes.
</summary>
<remarks>
<para>Polling occurs every 4 seconds.</para>
<para>This change token does not raise any change callbacks. Callers should watch for <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> to turn
from <see langword="false"/> to <see langword="true"/> and dispose the token after this happens.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.#ctor(System.IO.FileInfo)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" /> that polls the specified file for changes as
determined by <see cref="P:System.IO.FileSystemInfo.LastWriteTimeUtc" />.
</summary>
<param name="fileInfo">The <see cref="T:System.IO.FileInfo"/> to poll.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.ActiveChangeCallbacks">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged">
<summary>
Gets a value that indicates whether the file has changed since the change token was created.
</summary>
<remarks>
Once the file changes, this value is always <see langword="true"/>. Change tokens should not reused once expired. The caller should discard this
instance once it sees <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> is true.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.RegisterChangeCallback(System.Action{System.Object},System.Object)">
<summary>
Does not actually register callbacks.
</summary>
<param name="callback">This parameter is ignored.</param>
<param name="state">This parameter is ignored.</param>
<returns>A disposable object that no-ops when disposed.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken">
<summary>
A polling based <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> for wildcard patterns.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.#ctor(System.String,System.String)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken"/>.
</summary>
<param name="root">The root of the file system.</param>
<param name="pattern">The pattern to watch.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.ActiveChangeCallbacks">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.HasChanged">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.GetLastWriteUtc(System.String)">
<summary>
Gets the last write time of the file at the specified <paramref name="path"/>.
</summary>
<param name="path">The root relative path.</param>
<returns>The <see cref="T:System.DateTime"/> that the file was last modified.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents">
<summary>
Represents the contents of a physical file directory.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
<param name="filters">Specifies which files or directories are excluded from enumeration.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.Exists">
<inheritdoc/>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider">
<summary>
Looks up files using the on-disk file system.
</summary>
<remarks>
When the environment variable "DOTNET_USE_POLLING_FILE_WATCHER" is set to "1" or "true", calls to
<see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)" /> will use <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" />.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
<param name="filters">Specifies which files or directories are excluded.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
uses polling to determine file changes.
</summary>
<value>
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
By default, <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/> uses <see cref="T:System.IO.FileSystemWatcher"/> to listen to file change events
for <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/>. <see cref="T:System.IO.FileSystemWatcher"/> is ineffective in some scenarios such as mounted drives.
Polling is required to effectively watch for file changes.
</remarks>
<seealso cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling"/>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
actively polls for file changes.
</summary>
<value>
<see langword="true"/> if the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> returned by <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/> actively polls for file changes
(<see cref="P:Microsoft.Extensions.Primitives.IChangeToken.ActiveChangeCallbacks"/> will be <see langword="true"/>) instead of being passive.
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
<para>
This property is only effective when <see cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher"/> is set.
</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Root">
<summary>
Gets the root directory for this instance.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetFileInfo(System.String)">
<summary>
Locates a file at the given path by directly mapping path segments to physical directories.
</summary>
<param name="subpath">A path under the root directory.</param>
<returns>The file information. Caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IFileInfo.Exists"/> property.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetDirectoryContents(System.String)">
<summary>
Enumerates a directory at the given path, if any.
</summary>
<param name="subpath">A path under the root directory. Leading slashes are ignored.</param>
<returns>
The contents of the directory.
</returns>
<remarks>
<para>The caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IDirectoryContents.Exists"/> property.</para>
<para>Returns <see cref="T:Microsoft.Extensions.FileProviders.NotFoundDirectoryContents" /> if <paramref name="subpath" /> is absolute,
if the directory does not exist, or <paramref name="subpath" /> has invalid characters.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)">
<summary>
<para>Creates a <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for the specified <paramref name="filter" />.</para>
<para>Globbing patterns are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.</para>
</summary>
<param name="filter">
Filter string used to determine what files or folders to monitor. Example: **/*.cs, *.*,
subFolder/**/*.cshtml.
</param>
<returns>
An <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> that is notified when a file matching <paramref name="filter" /> is added,
modified, or deleted. Returns a <see cref="T:Microsoft.Extensions.FileProviders.NullChangeToken" /> if <paramref name="filter" /> has invalid filter
characters or if <paramref name="filter" /> is an absolute path or outside the root directory specified in the
constructor <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)" />.
</returns>
</member>
<member name="P:System.SR.Argument_InvalidOffLen">
<summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
</member>
<member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNum">
<summary>Non-negative number required.</summary>
</member>
<member name="P:System.SR.Error_FileSystemWatcherRequiredWithoutPolling">
<summary>The fileSystemWatcher parameter must be non-null when pollForChanges is false.</summary>
</member>
<member name="P:System.SR.CannotCreateStream">
<summary>Cannot create a stream for a directory.</summary>
</member>
<member name="P:System.SR.CannotModifyWhenFileWatcherInitialized">
<summary>Cannot modify {0} once file watcher has been initialized.</summary>
</member>
<member name="P:System.SR.Cryptography_HashAlgorithmNameNullOrEmpty">
<summary>The hash algorithm name cannot be null or empty.</summary>
</member>
<member name="P:System.SR.UnexpectedFileSystemInfo">
<summary>Unexpected type of FileSystemInfo</summary>
</member>
<member name="P:System.SR.FileSystemWatcher_PlatformNotSupported">
<summary>The type '{0}' is not supported on this platform, use polling instead.</summary>
</member>
</members>
</doc>
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.FileProviders.Physical</name>
</assembly>
<members>
<member name="T:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters">
<summary>
Specifies filtering behavior for files or directories.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Sensitive">
<summary>
Equivalent to <c>DotPrefixed | Hidden | System</c>. Exclude files and directories when the name begins with a period, or has either <see cref="F:System.IO.FileAttributes.Hidden"/> or <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.DotPrefixed">
<summary>
Exclude files and directories when the name begins with period.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Hidden">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.Hidden"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.System">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.None">
<summary>
Do not exclude any files.
</summary>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo">
<summary>
Represents a directory on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.#ctor(System.IO.DirectoryInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo"/> that wraps an instance of <see cref="T:System.IO.DirectoryInfo"/>.
</summary>
<param name="info">The directory to represent.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Length">
<summary>
Gets a value that's always -1.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.LastModified">
<summary>
Gets the time when the directory was last written to.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="true"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.CreateReadStream">
<summary>
Always throws an exception because read streams are not support on directories.
</summary>
<exception cref="T:System.InvalidOperationException">In all cases.</exception>
<returns>Never returns.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo">
<summary>
Represents a file on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.#ctor(System.IO.FileInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo"/> that wraps an instance of <see cref="T:System.IO.FileInfo"/>.
</summary>
<param name="info">The <see cref="T:System.IO.FileInfo"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Length">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.LastModified">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.CreateReadStream">
<inheritdoc />
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher">
<summary>
Watches a physical file system for changes and triggers events on
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> when files are created, change, renamed, or deleted.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that's watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that is watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
<param name="filters">Specifies which files or directories are excluded. Notifications of changes to are not raised to these.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)">
<summary>
Creates an instance of <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for all files and directories that match the
<paramref name="filter" />.
</summary>
<param name="filter">A globbing pattern for files and directories to watch.</param>
<returns>A change token for all files that match the filter.</returns>
<remarks>
Globbing patterns are relative to the root directory given in the constructor
<see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)" />. Globbing patterns
are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.
</remarks>
<exception cref="T:System.ArgumentNullException"><paramref name="filter" /> is <see langword="null"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken">
<summary>
A change token that polls for file system changes.
</summary>
<remarks>
<para>Polling occurs every 4 seconds.</para>
<para>This change token does not raise any change callbacks. Callers should watch for <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> to turn
from <see langword="false"/> to <see langword="true"/> and dispose the token after this happens.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.#ctor(System.IO.FileInfo)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" /> that polls the specified file for changes as
determined by <see cref="P:System.IO.FileSystemInfo.LastWriteTimeUtc" />.
</summary>
<param name="fileInfo">The <see cref="T:System.IO.FileInfo"/> to poll.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.ActiveChangeCallbacks">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged">
<summary>
Gets a value that indicates whether the file has changed since the change token was created.
</summary>
<remarks>
Once the file changes, this value is always <see langword="true"/>. Change tokens should not reused once expired. The caller should discard this
instance once it sees <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> is true.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.RegisterChangeCallback(System.Action{System.Object},System.Object)">
<summary>
Does not actually register callbacks.
</summary>
<param name="callback">This parameter is ignored.</param>
<param name="state">This parameter is ignored.</param>
<returns>A disposable object that no-ops when disposed.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken">
<summary>
A polling based <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> for wildcard patterns.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.#ctor(System.String,System.String)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken"/>.
</summary>
<param name="root">The root of the file system.</param>
<param name="pattern">The pattern to watch.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.ActiveChangeCallbacks">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.HasChanged">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.GetLastWriteUtc(System.String)">
<summary>
Gets the last write time of the file at the specified <paramref name="path"/>.
</summary>
<param name="path">The root relative path.</param>
<returns>The <see cref="T:System.DateTime"/> that the file was last modified.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents">
<summary>
Represents the contents of a physical file directory.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
<param name="filters">Specifies which files or directories are excluded from enumeration.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.Exists">
<inheritdoc/>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider">
<summary>
Looks up files using the on-disk file system.
</summary>
<remarks>
When the environment variable "DOTNET_USE_POLLING_FILE_WATCHER" is set to "1" or "true", calls to
<see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)" /> will use <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" />.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
<param name="filters">Specifies which files or directories are excluded.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
uses polling to determine file changes.
</summary>
<value>
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
By default, <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/> uses <see cref="T:System.IO.FileSystemWatcher"/> to listen to file change events
for <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/>. <see cref="T:System.IO.FileSystemWatcher"/> is ineffective in some scenarios such as mounted drives.
Polling is required to effectively watch for file changes.
</remarks>
<seealso cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling"/>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
actively polls for file changes.
</summary>
<value>
<see langword="true"/> if the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> returned by <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/> actively polls for file changes
(<see cref="P:Microsoft.Extensions.Primitives.IChangeToken.ActiveChangeCallbacks"/> will be <see langword="true"/>) instead of being passive.
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
<para>
This property is only effective when <see cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher"/> is set.
</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Root">
<summary>
Gets the root directory for this instance.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetFileInfo(System.String)">
<summary>
Locates a file at the given path by directly mapping path segments to physical directories.
</summary>
<param name="subpath">A path under the root directory.</param>
<returns>The file information. Caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IFileInfo.Exists"/> property.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetDirectoryContents(System.String)">
<summary>
Enumerates a directory at the given path, if any.
</summary>
<param name="subpath">A path under the root directory. Leading slashes are ignored.</param>
<returns>
The contents of the directory.
</returns>
<remarks>
<para>The caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IDirectoryContents.Exists"/> property.</para>
<para>Returns <see cref="T:Microsoft.Extensions.FileProviders.NotFoundDirectoryContents" /> if <paramref name="subpath" /> is absolute,
if the directory does not exist, or <paramref name="subpath" /> has invalid characters.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)">
<summary>
<para>Creates a <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for the specified <paramref name="filter" />.</para>
<para>Globbing patterns are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.</para>
</summary>
<param name="filter">
Filter string used to determine what files or folders to monitor. Example: **/*.cs, *.*,
subFolder/**/*.cshtml.
</param>
<returns>
An <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> that is notified when a file matching <paramref name="filter" /> is added,
modified, or deleted. Returns a <see cref="T:Microsoft.Extensions.FileProviders.NullChangeToken" /> if <paramref name="filter" /> has invalid filter
characters or if <paramref name="filter" /> is an absolute path or outside the root directory specified in the
constructor <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)" />.
</returns>
</member>
<member name="P:System.SR.Argument_InvalidOffLen">
<summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
</member>
<member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNum">
<summary>Non-negative number required.</summary>
</member>
<member name="P:System.SR.Error_FileSystemWatcherRequiredWithoutPolling">
<summary>The fileSystemWatcher parameter must be non-null when pollForChanges is false.</summary>
</member>
<member name="P:System.SR.CannotCreateStream">
<summary>Cannot create a stream for a directory.</summary>
</member>
<member name="P:System.SR.CannotModifyWhenFileWatcherInitialized">
<summary>Cannot modify {0} once file watcher has been initialized.</summary>
</member>
<member name="P:System.SR.Cryptography_HashAlgorithmNameNullOrEmpty">
<summary>The hash algorithm name cannot be null or empty.</summary>
</member>
<member name="P:System.SR.UnexpectedFileSystemInfo">
<summary>Unexpected type of FileSystemInfo</summary>
</member>
<member name="P:System.SR.FileSystemWatcher_PlatformNotSupported">
<summary>The type '{0}' is not supported on this platform, use polling instead.</summary>
</member>
</members>
</doc>

View File

@@ -1,393 +1,393 @@
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.FileProviders.Physical</name>
</assembly>
<members>
<member name="T:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters">
<summary>
Specifies filtering behavior for files or directories.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Sensitive">
<summary>
Equivalent to <c>DotPrefixed | Hidden | System</c>. Exclude files and directories when the name begins with a period, or has either <see cref="F:System.IO.FileAttributes.Hidden"/> or <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.DotPrefixed">
<summary>
Exclude files and directories when the name begins with period.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Hidden">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.Hidden"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.System">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.None">
<summary>
Do not exclude any files.
</summary>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo">
<summary>
Represents a directory on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.#ctor(System.IO.DirectoryInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo"/> that wraps an instance of <see cref="T:System.IO.DirectoryInfo"/>.
</summary>
<param name="info">The directory to represent.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Length">
<summary>
Gets a value that's always -1.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.LastModified">
<summary>
Gets the time when the directory was last written to.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="true"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.CreateReadStream">
<summary>
Always throws an exception because read streams are not support on directories.
</summary>
<exception cref="T:System.InvalidOperationException">In all cases.</exception>
<returns>Never returns.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo">
<summary>
Represents a file on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.#ctor(System.IO.FileInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo"/> that wraps an instance of <see cref="T:System.IO.FileInfo"/>.
</summary>
<param name="info">The <see cref="T:System.IO.FileInfo"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Length">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.LastModified">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.CreateReadStream">
<inheritdoc />
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher">
<summary>
Watches a physical file system for changes and triggers events on
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> when files are created, change, renamed, or deleted.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that's watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that is watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
<param name="filters">Specifies which files or directories are excluded. Notifications of changes to are not raised to these.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)">
<summary>
Creates an instance of <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for all files and directories that match the
<paramref name="filter" />.
</summary>
<param name="filter">A globbing pattern for files and directories to watch.</param>
<returns>A change token for all files that match the filter.</returns>
<remarks>
Globbing patterns are relative to the root directory given in the constructor
<see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)" />. Globbing patterns
are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.
</remarks>
<exception cref="T:System.ArgumentNullException"><paramref name="filter" /> is <see langword="null"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken">
<summary>
A change token that polls for file system changes.
</summary>
<remarks>
<para>Polling occurs every 4 seconds.</para>
<para>This change token does not raise any change callbacks. Callers should watch for <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> to turn
from <see langword="false"/> to <see langword="true"/> and dispose the token after this happens.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.#ctor(System.IO.FileInfo)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" /> that polls the specified file for changes as
determined by <see cref="P:System.IO.FileSystemInfo.LastWriteTimeUtc" />.
</summary>
<param name="fileInfo">The <see cref="T:System.IO.FileInfo"/> to poll.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.ActiveChangeCallbacks">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged">
<summary>
Gets a value that indicates whether the file has changed since the change token was created.
</summary>
<remarks>
Once the file changes, this value is always <see langword="true"/>. Change tokens should not reused once expired. The caller should discard this
instance once it sees <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> is true.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.RegisterChangeCallback(System.Action{System.Object},System.Object)">
<summary>
Does not actually register callbacks.
</summary>
<param name="callback">This parameter is ignored.</param>
<param name="state">This parameter is ignored.</param>
<returns>A disposable object that no-ops when disposed.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken">
<summary>
A polling based <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> for wildcard patterns.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.#ctor(System.String,System.String)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken"/>.
</summary>
<param name="root">The root of the file system.</param>
<param name="pattern">The pattern to watch.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.ActiveChangeCallbacks">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.HasChanged">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.GetLastWriteUtc(System.String)">
<summary>
Gets the last write time of the file at the specified <paramref name="path"/>.
</summary>
<param name="path">The root relative path.</param>
<returns>The <see cref="T:System.DateTime"/> that the file was last modified.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents">
<summary>
Represents the contents of a physical file directory.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
<param name="filters">Specifies which files or directories are excluded from enumeration.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.Exists">
<inheritdoc/>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider">
<summary>
Looks up files using the on-disk file system.
</summary>
<remarks>
When the environment variable "DOTNET_USE_POLLING_FILE_WATCHER" is set to "1" or "true", calls to
<see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)" /> will use <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" />.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
<param name="filters">Specifies which files or directories are excluded.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
uses polling to determine file changes.
</summary>
<value>
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
By default, <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/> uses <see cref="T:System.IO.FileSystemWatcher"/> to listen to file change events
for <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/>. <see cref="T:System.IO.FileSystemWatcher"/> is ineffective in some scenarios such as mounted drives.
Polling is required to effectively watch for file changes.
</remarks>
<seealso cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling"/>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
actively polls for file changes.
</summary>
<value>
<see langword="true"/> if the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> returned by <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/> actively polls for file changes
(<see cref="P:Microsoft.Extensions.Primitives.IChangeToken.ActiveChangeCallbacks"/> will be <see langword="true"/>) instead of being passive.
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
<para>
This property is only effective when <see cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher"/> is set.
</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Root">
<summary>
Gets the root directory for this instance.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetFileInfo(System.String)">
<summary>
Locates a file at the given path by directly mapping path segments to physical directories.
</summary>
<param name="subpath">A path under the root directory.</param>
<returns>The file information. Caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IFileInfo.Exists"/> property.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetDirectoryContents(System.String)">
<summary>
Enumerates a directory at the given path, if any.
</summary>
<param name="subpath">A path under the root directory. Leading slashes are ignored.</param>
<returns>
The contents of the directory.
</returns>
<remarks>
<para>The caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IDirectoryContents.Exists"/> property.</para>
<para>Returns <see cref="T:Microsoft.Extensions.FileProviders.NotFoundDirectoryContents" /> if <paramref name="subpath" /> is absolute,
if the directory does not exist, or <paramref name="subpath" /> has invalid characters.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)">
<summary>
<para>Creates a <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for the specified <paramref name="filter" />.</para>
<para>Globbing patterns are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.</para>
</summary>
<param name="filter">
Filter string used to determine what files or folders to monitor. Example: **/*.cs, *.*,
subFolder/**/*.cshtml.
</param>
<returns>
An <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> that is notified when a file matching <paramref name="filter" /> is added,
modified, or deleted. Returns a <see cref="T:Microsoft.Extensions.FileProviders.NullChangeToken" /> if <paramref name="filter" /> has invalid filter
characters or if <paramref name="filter" /> is an absolute path or outside the root directory specified in the
constructor <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)" />.
</returns>
</member>
<member name="P:System.SR.Argument_InvalidOffLen">
<summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
</member>
<member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNum">
<summary>Non-negative number required.</summary>
</member>
<member name="P:System.SR.Error_FileSystemWatcherRequiredWithoutPolling">
<summary>The fileSystemWatcher parameter must be non-null when pollForChanges is false.</summary>
</member>
<member name="P:System.SR.CannotCreateStream">
<summary>Cannot create a stream for a directory.</summary>
</member>
<member name="P:System.SR.CannotModifyWhenFileWatcherInitialized">
<summary>Cannot modify {0} once file watcher has been initialized.</summary>
</member>
<member name="P:System.SR.Cryptography_HashAlgorithmNameNullOrEmpty">
<summary>The hash algorithm name cannot be null or empty.</summary>
</member>
<member name="P:System.SR.UnexpectedFileSystemInfo">
<summary>Unexpected type of FileSystemInfo</summary>
</member>
<member name="P:System.SR.FileSystemWatcher_PlatformNotSupported">
<summary>The type '{0}' is not supported on this platform, use polling instead.</summary>
</member>
</members>
</doc>
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.FileProviders.Physical</name>
</assembly>
<members>
<member name="T:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters">
<summary>
Specifies filtering behavior for files or directories.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Sensitive">
<summary>
Equivalent to <c>DotPrefixed | Hidden | System</c>. Exclude files and directories when the name begins with a period, or has either <see cref="F:System.IO.FileAttributes.Hidden"/> or <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.DotPrefixed">
<summary>
Exclude files and directories when the name begins with period.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.Hidden">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.Hidden"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.System">
<summary>
Exclude files and directories when <see cref="F:System.IO.FileAttributes.System"/> is set on <see cref="P:System.IO.FileSystemInfo.Attributes"/>.
</summary>
</member>
<member name="F:Microsoft.Extensions.FileProviders.Physical.ExclusionFilters.None">
<summary>
Do not exclude any files.
</summary>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo">
<summary>
Represents a directory on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.#ctor(System.IO.DirectoryInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo"/> that wraps an instance of <see cref="T:System.IO.DirectoryInfo"/>.
</summary>
<param name="info">The directory to represent.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Length">
<summary>
Gets a value that's always -1.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.LastModified">
<summary>
Gets the time when the directory was last written to.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="true"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.CreateReadStream">
<summary>
Always throws an exception because read streams are not support on directories.
</summary>
<exception cref="T:System.InvalidOperationException">In all cases.</exception>
<returns>Never returns.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalDirectoryInfo.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo">
<summary>
Represents a file on a physical file system.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.#ctor(System.IO.FileInfo)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo"/> that wraps an instance of <see cref="T:System.IO.FileInfo"/>.
</summary>
<param name="info">The <see cref="T:System.IO.FileInfo"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Exists">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Length">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.PhysicalPath">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.Name">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.LastModified">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.IsDirectory">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFileInfo.CreateReadStream">
<inheritdoc />
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher">
<summary>
Watches a physical file system for changes and triggers events on
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> when files are created, change, renamed, or deleted.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that's watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher" /> that watches files in <paramref name="root" />.
Wraps an instance of <see cref="T:System.IO.FileSystemWatcher" />.
</summary>
<param name="root">Root directory for the watcher.</param>
<param name="fileSystemWatcher">The wrapped watcher that is watching <paramref name="root" />.</param>
<param name="pollForChanges">
<see langword="true"/> for the poller to use polling to trigger instances of
<see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> created by <see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)" />.
</param>
<param name="filters">Specifies which files or directories are excluded. Notifications of changes to are not raised to these.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.CreateFileChangeToken(System.String)">
<summary>
Creates an instance of <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for all files and directories that match the
<paramref name="filter" />.
</summary>
<param name="filter">A globbing pattern for files and directories to watch.</param>
<returns>A change token for all files that match the filter.</returns>
<remarks>
Globbing patterns are relative to the root directory given in the constructor
<see cref="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.#ctor(System.String,System.IO.FileSystemWatcher,System.Boolean)" />. Globbing patterns
are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.
</remarks>
<exception cref="T:System.ArgumentNullException"><paramref name="filter" /> is <see langword="null"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PhysicalFilesWatcher.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken">
<summary>
A change token that polls for file system changes.
</summary>
<remarks>
<para>Polling occurs every 4 seconds.</para>
<para>This change token does not raise any change callbacks. Callers should watch for <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> to turn
from <see langword="false"/> to <see langword="true"/> and dispose the token after this happens.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.#ctor(System.IO.FileInfo)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" /> that polls the specified file for changes as
determined by <see cref="P:System.IO.FileSystemInfo.LastWriteTimeUtc" />.
</summary>
<param name="fileInfo">The <see cref="T:System.IO.FileInfo"/> to poll.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.ActiveChangeCallbacks">
<summary>
Gets a value that's always <see langword="false"/>.
</summary>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged">
<summary>
Gets a value that indicates whether the file has changed since the change token was created.
</summary>
<remarks>
Once the file changes, this value is always <see langword="true"/>. Change tokens should not reused once expired. The caller should discard this
instance once it sees <see cref="P:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.HasChanged" /> is true.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken.RegisterChangeCallback(System.Action{System.Object},System.Object)">
<summary>
Does not actually register callbacks.
</summary>
<param name="callback">This parameter is ignored.</param>
<param name="state">This parameter is ignored.</param>
<returns>A disposable object that no-ops when disposed.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken">
<summary>
A polling based <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> for wildcard patterns.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.#ctor(System.String,System.String)">
<summary>
Initializes a new instance of <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken"/>.
</summary>
<param name="root">The root of the file system.</param>
<param name="pattern">The pattern to watch.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.ActiveChangeCallbacks">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.HasChanged">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.FileProviders.Physical.PollingWildCardChangeToken.GetLastWriteUtc(System.String)">
<summary>
Gets the last write time of the file at the specified <paramref name="path"/>.
</summary>
<param name="path">The root relative path.</param>
<returns>The <see cref="T:System.DateTime"/> that the file was last modified.</returns>
</member>
<member name="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents">
<summary>
Represents the contents of a physical file directory.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes an instance of <see cref="T:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents"/>.
</summary>
<param name="directory">The directory to represent.</param>
<param name="filters">Specifies which files or directories are excluded from enumeration.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.Exists">
<inheritdoc/>
</member>
<member name="M:Microsoft.Extensions.FileProviders.Internal.PhysicalDirectoryContents.GetEnumerator">
<inheritdoc/>
</member>
<member name="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider">
<summary>
Looks up files using the on-disk file system.
</summary>
<remarks>
When the environment variable "DOTNET_USE_POLLING_FILE_WATCHER" is set to "1" or "true", calls to
<see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)" /> will use <see cref="T:Microsoft.Extensions.FileProviders.Physical.PollingFileChangeToken" />.
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String,Microsoft.Extensions.FileProviders.Physical.ExclusionFilters)">
<summary>
Initializes a new instance of a PhysicalFileProvider at the given root directory.
</summary>
<param name="root">The root directory. This should be an absolute path.</param>
<param name="filters">Specifies which files or directories are excluded.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
uses polling to determine file changes.
</summary>
<value>
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
By default, <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/> uses <see cref="T:System.IO.FileSystemWatcher"/> to listen to file change events
for <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/>. <see cref="T:System.IO.FileSystemWatcher"/> is ineffective in some scenarios such as mounted drives.
Polling is required to effectively watch for file changes.
</remarks>
<seealso cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling"/>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UseActivePolling">
<summary>
Gets or sets a value that determines if this instance of <see cref="T:Microsoft.Extensions.FileProviders.PhysicalFileProvider"/>
actively polls for file changes.
</summary>
<value>
<see langword="true"/> if the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> returned by <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)"/> actively polls for file changes
(<see cref="P:Microsoft.Extensions.Primitives.IChangeToken.ActiveChangeCallbacks"/> will be <see langword="true"/>) instead of being passive.
The default value of this property is determined by the value of environment variable named <c>DOTNET_USE_POLLING_FILE_WATCHER</c>.
When <see langword="true"/> or <c>1</c>, this property defaults to <see langword="true"/>; otherwise <see langword="false"/>.
</value>
<remarks>
<para>
This property is only effective when <see cref="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.UsePollingFileWatcher"/> is set.
</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose">
<summary>
Disposes the provider. Change tokens may not trigger after the provider is disposed.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Dispose(System.Boolean)">
<summary>
Disposes the provider.
</summary>
<param name="disposing"><c>true</c> is invoked from <see cref="M:System.IDisposable.Dispose"/>.</param>
</member>
<member name="P:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Root">
<summary>
Gets the root directory for this instance.
</summary>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetFileInfo(System.String)">
<summary>
Locates a file at the given path by directly mapping path segments to physical directories.
</summary>
<param name="subpath">A path under the root directory.</param>
<returns>The file information. Caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IFileInfo.Exists"/> property.</returns>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.GetDirectoryContents(System.String)">
<summary>
Enumerates a directory at the given path, if any.
</summary>
<param name="subpath">A path under the root directory. Leading slashes are ignored.</param>
<returns>
The contents of the directory.
</returns>
<remarks>
<para>The caller must check the <see cref="P:Microsoft.Extensions.FileProviders.IDirectoryContents.Exists"/> property.</para>
<para>Returns <see cref="T:Microsoft.Extensions.FileProviders.NotFoundDirectoryContents" /> if <paramref name="subpath" /> is absolute,
if the directory does not exist, or <paramref name="subpath" /> has invalid characters.</para>
</remarks>
</member>
<member name="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.Watch(System.String)">
<summary>
<para>Creates a <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> for the specified <paramref name="filter" />.</para>
<para>Globbing patterns are interpreted by <see cref="T:Microsoft.Extensions.FileSystemGlobbing.Matcher" />.</para>
</summary>
<param name="filter">
Filter string used to determine what files or folders to monitor. Example: **/*.cs, *.*,
subFolder/**/*.cshtml.
</param>
<returns>
An <see cref="T:Microsoft.Extensions.Primitives.IChangeToken" /> that is notified when a file matching <paramref name="filter" /> is added,
modified, or deleted. Returns a <see cref="T:Microsoft.Extensions.FileProviders.NullChangeToken" /> if <paramref name="filter" /> has invalid filter
characters or if <paramref name="filter" /> is an absolute path or outside the root directory specified in the
constructor <see cref="M:Microsoft.Extensions.FileProviders.PhysicalFileProvider.#ctor(System.String)" />.
</returns>
</member>
<member name="P:System.SR.Argument_InvalidOffLen">
<summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
</member>
<member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNum">
<summary>Non-negative number required.</summary>
</member>
<member name="P:System.SR.Error_FileSystemWatcherRequiredWithoutPolling">
<summary>The fileSystemWatcher parameter must be non-null when pollForChanges is false.</summary>
</member>
<member name="P:System.SR.CannotCreateStream">
<summary>Cannot create a stream for a directory.</summary>
</member>
<member name="P:System.SR.CannotModifyWhenFileWatcherInitialized">
<summary>Cannot modify {0} once file watcher has been initialized.</summary>
</member>
<member name="P:System.SR.Cryptography_HashAlgorithmNameNullOrEmpty">
<summary>The hash algorithm name cannot be null or empty.</summary>
</member>
<member name="P:System.SR.UnexpectedFileSystemInfo">
<summary>Unexpected type of FileSystemInfo</summary>
</member>
<member name="P:System.SR.FileSystemWatcher_PlatformNotSupported">
<summary>The type '{0}' is not supported on this platform, use polling instead.</summary>
</member>
</members>
</doc>