nuget updates
This commit is contained in:
@@ -0,0 +1,5 @@
|
||||
{
|
||||
"version": 2,
|
||||
"contentHash": "3+RiR6TEakDL0dCUqR7PjFffyrVMLdx/vAVBiN1mGmwScKYCTePIkYVkWsX85CTKh7R9J4M9C1MHzVdjbKcg3g==",
|
||||
"source": "https://api.nuget.org/v3/index.json"
|
||||
}
|
||||
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 2.1 KiB |
@@ -0,0 +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>
|
||||
</package>
|
||||
@@ -0,0 +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).
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +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 <SuppressTfmSupportBuildWarnings>true</SuppressTfmSupportBuildWarnings> in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
|
||||
</Target>
|
||||
</Project>
|
||||
@@ -0,0 +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 <SuppressTfmSupportBuildWarnings>true</SuppressTfmSupportBuildWarnings> in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
|
||||
</Target>
|
||||
</Project>
|
||||
@@ -0,0 +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>
|
||||
@@ -0,0 +1,756 @@
|
||||
<?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="T:System.Security.Cryptography.IncrementalHash">
|
||||
<summary>
|
||||
Provides support for computing a hash or HMAC value incrementally across several segments.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="P:System.Security.Cryptography.IncrementalHash.AlgorithmName">
|
||||
<summary>
|
||||
Get the name of the algorithm being performed.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="M:System.Security.Cryptography.IncrementalHash.AppendData(System.Byte[])">
|
||||
<summary>
|
||||
Append the entire contents of <paramref name="data"/> to the data already processed in the hash or HMAC.
|
||||
</summary>
|
||||
<param name="data">The data to process.</param>
|
||||
<exception cref="T:System.ArgumentNullException"><paramref name="data"/> is <c>null</c>.</exception>
|
||||
<exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
|
||||
</member>
|
||||
<member name="M:System.Security.Cryptography.IncrementalHash.AppendData(System.Byte[],System.Int32,System.Int32)">
|
||||
<summary>
|
||||
Append <paramref name="count"/> bytes of <paramref name="data"/>, starting at <paramref name="offset"/>,
|
||||
to the data already processed in the hash or HMAC.
|
||||
</summary>
|
||||
<param name="data">The data to process.</param>
|
||||
<param name="offset">The offset into the byte array from which to begin using data.</param>
|
||||
<param name="count">The number of bytes in the array to use as data.</param>
|
||||
<exception cref="T:System.ArgumentNullException"><paramref name="data"/> is <c>null</c>.</exception>
|
||||
<exception cref="T:System.ArgumentOutOfRangeException">
|
||||
<paramref name="offset"/> is out of range. This parameter requires a non-negative number.
|
||||
</exception>
|
||||
<exception cref="T:System.ArgumentOutOfRangeException">
|
||||
<paramref name="count"/> is out of range. This parameter requires a non-negative number less than
|
||||
the <see cref="P:System.Array.Length"/> value of <paramref name="data"/>.
|
||||
</exception>
|
||||
<exception cref="T:System.ArgumentException">
|
||||
<paramref name="count"/> is greater than
|
||||
<paramref name="data"/>.<see cref="P:System.Array.Length"/> - <paramref name="offset"/>.
|
||||
</exception>
|
||||
<exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
|
||||
</member>
|
||||
<member name="M:System.Security.Cryptography.IncrementalHash.GetHashAndReset">
|
||||
<summary>
|
||||
Retrieve the hash or HMAC for the data accumulated from prior calls to
|
||||
<see cref="M:System.Security.Cryptography.IncrementalHash.AppendData(System.Byte[])"/>, and return to the state the object
|
||||
was in at construction.
|
||||
</summary>
|
||||
<returns>The computed hash or HMAC.</returns>
|
||||
<exception cref="T:System.ObjectDisposedException">The object has already been disposed.</exception>
|
||||
</member>
|
||||
<member name="M:System.Security.Cryptography.IncrementalHash.Dispose">
|
||||
<summary>
|
||||
Release all resources used by the current instance of the
|
||||
<see cref="T:System.Security.Cryptography.IncrementalHash"/> class.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="M:System.Security.Cryptography.IncrementalHash.CreateHash(System.Security.Cryptography.HashAlgorithmName)">
|
||||
<summary>
|
||||
Create an <see cref="T:System.Security.Cryptography.IncrementalHash"/> for the algorithm specified by <paramref name="hashAlgorithm"/>.
|
||||
</summary>
|
||||
<param name="hashAlgorithm">The name of the hash algorithm to perform.</param>
|
||||
<returns>
|
||||
An <see cref="T:System.Security.Cryptography.IncrementalHash"/> instance ready to compute the hash algorithm specified
|
||||
by <paramref name="hashAlgorithm"/>.
|
||||
</returns>
|
||||
<exception cref="T:System.ArgumentException">
|
||||
<paramref name="hashAlgorithm"/>.<see cref="P:System.Security.Cryptography.HashAlgorithmName.Name"/> is <c>null</c>, or
|
||||
the empty string.
|
||||
</exception>
|
||||
<exception cref="T:System.Security.Cryptography.CryptographicException"><paramref name="hashAlgorithm"/> is not a known hash algorithm.</exception>
|
||||
</member>
|
||||
<member name="M:System.Security.Cryptography.IncrementalHash.CreateHMAC(System.Security.Cryptography.HashAlgorithmName,System.Byte[])">
|
||||
<summary>
|
||||
Create an <see cref="T:System.Security.Cryptography.IncrementalHash"/> for the Hash-based Message Authentication Code (HMAC)
|
||||
algorithm utilizing the hash algorithm specified by <paramref name="hashAlgorithm"/>, and a
|
||||
key specified by <paramref name="key"/>.
|
||||
</summary>
|
||||
<param name="hashAlgorithm">The name of the hash algorithm to perform within the HMAC.</param>
|
||||
<param name="key">
|
||||
The secret key for the HMAC. The key can be any length, but a key longer than the output size
|
||||
of the hash algorithm specified by <paramref name="hashAlgorithm"/> will be hashed (using the
|
||||
algorithm specified by <paramref name="hashAlgorithm"/>) to derive a correctly-sized key. Therefore,
|
||||
the recommended size of the secret key is the output size of the hash specified by
|
||||
<paramref name="hashAlgorithm"/>.
|
||||
</param>
|
||||
<returns>
|
||||
An <see cref="T:System.Security.Cryptography.IncrementalHash"/> instance ready to compute the hash algorithm specified
|
||||
by <paramref name="hashAlgorithm"/>.
|
||||
</returns>
|
||||
<exception cref="T:System.ArgumentException">
|
||||
<paramref name="hashAlgorithm"/>.<see cref="P:System.Security.Cryptography.HashAlgorithmName.Name"/> is <c>null</c>, or
|
||||
the empty string.
|
||||
</exception>
|
||||
<exception cref="T:System.Security.Cryptography.CryptographicException"><paramref name="hashAlgorithm"/> is not a known hash algorithm.</exception>
|
||||
</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>
|
||||
<member name="T:System.Runtime.InteropServices.LibraryImportAttribute">
|
||||
<summary>
|
||||
Attribute used to indicate a source generator should create a function for marshalling
|
||||
arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time.
|
||||
</summary>
|
||||
<remarks>
|
||||
This attribute is meaningless if the source generator associated with it is not enabled.
|
||||
The current built-in source generator only supports C# and only supplies an implementation when
|
||||
applied to static, partial, non-generic methods.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="M:System.Runtime.InteropServices.LibraryImportAttribute.#ctor(System.String)">
|
||||
<summary>
|
||||
Initializes a new instance of the <see cref="T:System.Runtime.InteropServices.LibraryImportAttribute"/>.
|
||||
</summary>
|
||||
<param name="libraryName">Name of the library containing the import.</param>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.LibraryName">
|
||||
<summary>
|
||||
Gets the name of the library containing the import.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.EntryPoint">
|
||||
<summary>
|
||||
Gets or sets the name of the entry point to be called.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling">
|
||||
<summary>
|
||||
Gets or sets how to marshal string arguments to the method.
|
||||
</summary>
|
||||
<remarks>
|
||||
If this field is set to a value other than <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />,
|
||||
<see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType" /> must not be specified.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType">
|
||||
<summary>
|
||||
Gets or sets the <see cref="T:System.Type"/> used to control how string arguments to the method are marshalled.
|
||||
</summary>
|
||||
<remarks>
|
||||
If this field is specified, <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling" /> must not be specified
|
||||
or must be set to <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.SetLastError">
|
||||
<summary>
|
||||
Gets or sets whether the callee sets an error (SetLastError on Windows or errno
|
||||
on other platforms) before returning from the attributed method.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.InteropServices.StringMarshalling">
|
||||
<summary>
|
||||
Specifies how strings should be marshalled for generated p/invokes
|
||||
</summary>
|
||||
</member>
|
||||
<member name="F:System.Runtime.InteropServices.StringMarshalling.Custom">
|
||||
<summary>
|
||||
Indicates the user is supplying a specific marshaller in <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType"/>.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="F:System.Runtime.InteropServices.StringMarshalling.Utf8">
|
||||
<summary>
|
||||
Use the platform-provided UTF-8 marshaller.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="F:System.Runtime.InteropServices.StringMarshalling.Utf16">
|
||||
<summary>
|
||||
Use the platform-provided UTF-16 marshaller.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.OSPlatformAttribute">
|
||||
<summary>
|
||||
Base type for all platform-specific API attributes.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.TargetPlatformAttribute">
|
||||
<summary>
|
||||
Records the platform that the project targeted.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.SupportedOSPlatformAttribute">
|
||||
<summary>
|
||||
Records the operating system (and minimum version) that supports an API. Multiple attributes can be
|
||||
applied to indicate support on multiple operating systems.
|
||||
</summary>
|
||||
<remarks>
|
||||
Callers can apply a <see cref="T:System.Runtime.Versioning.SupportedOSPlatformAttribute" />
|
||||
or use guards to prevent calls to APIs on unsupported operating systems.
|
||||
|
||||
A given platform should only be specified once.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.UnsupportedOSPlatformAttribute">
|
||||
<summary>
|
||||
Marks APIs that were removed in a given operating system version.
|
||||
</summary>
|
||||
<remarks>
|
||||
Primarily used by OS bindings to indicate APIs that are only available in
|
||||
earlier versions.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.ObsoletedOSPlatformAttribute">
|
||||
<summary>
|
||||
Marks APIs that were obsoleted in a given operating system version.
|
||||
</summary>
|
||||
<remarks>
|
||||
Primarily used by OS bindings to indicate APIs that should not be used anymore.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="M:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.#ctor(System.String)">
|
||||
<summary>
|
||||
Initializes a new instance of the <see cref="T:System.Runtime.Versioning.ObsoletedOSPlatformAttribute"/> class with the specified platform name.
|
||||
</summary>
|
||||
<param name="platformName">The name of the platform where the API was obsoleted.</param>
|
||||
</member>
|
||||
<member name="M:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.#ctor(System.String,System.String)">
|
||||
<summary>
|
||||
Initializes a new instance of the <see cref="T:System.Runtime.Versioning.ObsoletedOSPlatformAttribute"/> class with the specified platform name and message.
|
||||
</summary>
|
||||
<param name="platformName">The name of the platform where the API was obsoleted.</param>
|
||||
<param name="message">The message that explains the obsolescence.</param>
|
||||
</member>
|
||||
<member name="P:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.Message">
|
||||
<summary>
|
||||
Gets the message that explains the obsolescence.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="P:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.Url">
|
||||
<summary>
|
||||
Gets or sets the URL that provides more information about the obsolescence.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.SupportedOSPlatformGuardAttribute">
|
||||
<summary>
|
||||
Annotates a custom guard field, property or method with a supported platform name and optional version.
|
||||
Multiple attributes can be applied to indicate guard for multiple supported platforms.
|
||||
</summary>
|
||||
<remarks>
|
||||
Callers can apply a <see cref="T:System.Runtime.Versioning.SupportedOSPlatformGuardAttribute" /> to a field, property or method
|
||||
and use that field, property or method in a conditional or assert statements in order to safely call platform specific APIs.
|
||||
|
||||
The type of the field or property should be boolean, the method return type should be boolean in order to be used as platform guard.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.UnsupportedOSPlatformGuardAttribute">
|
||||
<summary>
|
||||
Annotates the custom guard field, property or method with an unsupported platform name and optional version.
|
||||
Multiple attributes can be applied to indicate guard for multiple unsupported platforms.
|
||||
</summary>
|
||||
<remarks>
|
||||
Callers can apply a <see cref="T:System.Runtime.Versioning.UnsupportedOSPlatformGuardAttribute" /> to a field, property or method
|
||||
and use that field, property or method in a conditional or assert statements as a guard to safely call APIs unsupported on those platforms.
|
||||
|
||||
The type of the field or property should be boolean, the method return type should be boolean in order to be used as platform guard.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.AllowNullAttribute">
|
||||
<summary>Specifies that null is allowed as an input even if the corresponding type disallows it.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.DisallowNullAttribute">
|
||||
<summary>Specifies that null is disallowed as an input even if the corresponding type allows it.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MaybeNullAttribute">
|
||||
<summary>Specifies that an output may be null even if the corresponding type disallows it.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.NotNullAttribute">
|
||||
<summary>Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute">
|
||||
<summary>Specifies that when a method returns <see cref="P:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute.ReturnValue"/>, the parameter may be null even if the corresponding type disallows it.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute.#ctor(System.Boolean)">
|
||||
<summary>Initializes the attribute with the specified return value condition.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated parameter may be null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute.ReturnValue">
|
||||
<summary>Gets the return value condition.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute">
|
||||
<summary>Specifies that when a method returns <see cref="P:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute.ReturnValue"/>, the parameter will not be null even if the corresponding type allows it.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute.#ctor(System.Boolean)">
|
||||
<summary>Initializes the attribute with the specified return value condition.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated parameter will not be null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute.ReturnValue">
|
||||
<summary>Gets the return value condition.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute">
|
||||
<summary>Specifies that the output will be non-null if the named parameter is non-null.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute.#ctor(System.String)">
|
||||
<summary>Initializes the attribute with the associated parameter name.</summary>
|
||||
<param name="parameterName">
|
||||
The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute.ParameterName">
|
||||
<summary>Gets the associated parameter name.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.DoesNotReturnAttribute">
|
||||
<summary>Applied to a method that will never return under any circumstance.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute">
|
||||
<summary>Specifies that the method will not return if the associated Boolean parameter is passed the specified value.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute.#ctor(System.Boolean)">
|
||||
<summary>Initializes the attribute with the specified parameter value.</summary>
|
||||
<param name="parameterValue">
|
||||
The condition parameter value. Code after the method will be considered unreachable by diagnostics if the argument to
|
||||
the associated parameter matches this value.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute.ParameterValue">
|
||||
<summary>Gets the condition parameter value.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute">
|
||||
<summary>Specifies that the method or property will ensure that the listed field and property members have not-null values.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute.#ctor(System.String)">
|
||||
<summary>Initializes the attribute with a field or property member.</summary>
|
||||
<param name="member">
|
||||
The field or property member that is promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute.#ctor(System.String[])">
|
||||
<summary>Initializes the attribute with the list of field and property members.</summary>
|
||||
<param name="members">
|
||||
The list of field and property members that are promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute.Members">
|
||||
<summary>Gets field or property member names.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute">
|
||||
<summary>Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.#ctor(System.Boolean,System.String)">
|
||||
<summary>Initializes the attribute with the specified return value condition and a field or property member.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated field or property member will not be null.
|
||||
</param>
|
||||
<param name="member">
|
||||
The field or property member that is promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.#ctor(System.Boolean,System.String[])">
|
||||
<summary>Initializes the attribute with the specified return value condition and list of field and property members.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated field and property members will not be null.
|
||||
</param>
|
||||
<param name="members">
|
||||
The list of field and property members that are promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.ReturnValue">
|
||||
<summary>Gets the return value condition.</summary>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.Members">
|
||||
<summary>Gets field or property member names.</summary>
|
||||
</member>
|
||||
<member name="T:System.ExceptionPolyfills">
|
||||
<summary>Provides downlevel polyfills for static methods on Exception-derived types.</summary>
|
||||
</member>
|
||||
</members>
|
||||
</doc>
|
||||
@@ -0,0 +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>
|
||||
@@ -0,0 +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>
|
||||
@@ -0,0 +1,662 @@
|
||||
<?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>
|
||||
<member name="T:System.Runtime.InteropServices.LibraryImportAttribute">
|
||||
<summary>
|
||||
Attribute used to indicate a source generator should create a function for marshalling
|
||||
arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time.
|
||||
</summary>
|
||||
<remarks>
|
||||
This attribute is meaningless if the source generator associated with it is not enabled.
|
||||
The current built-in source generator only supports C# and only supplies an implementation when
|
||||
applied to static, partial, non-generic methods.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="M:System.Runtime.InteropServices.LibraryImportAttribute.#ctor(System.String)">
|
||||
<summary>
|
||||
Initializes a new instance of the <see cref="T:System.Runtime.InteropServices.LibraryImportAttribute"/>.
|
||||
</summary>
|
||||
<param name="libraryName">Name of the library containing the import.</param>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.LibraryName">
|
||||
<summary>
|
||||
Gets the name of the library containing the import.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.EntryPoint">
|
||||
<summary>
|
||||
Gets or sets the name of the entry point to be called.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling">
|
||||
<summary>
|
||||
Gets or sets how to marshal string arguments to the method.
|
||||
</summary>
|
||||
<remarks>
|
||||
If this field is set to a value other than <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />,
|
||||
<see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType" /> must not be specified.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType">
|
||||
<summary>
|
||||
Gets or sets the <see cref="T:System.Type"/> used to control how string arguments to the method are marshalled.
|
||||
</summary>
|
||||
<remarks>
|
||||
If this field is specified, <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling" /> must not be specified
|
||||
or must be set to <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="P:System.Runtime.InteropServices.LibraryImportAttribute.SetLastError">
|
||||
<summary>
|
||||
Gets or sets whether the callee sets an error (SetLastError on Windows or errno
|
||||
on other platforms) before returning from the attributed method.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.InteropServices.StringMarshalling">
|
||||
<summary>
|
||||
Specifies how strings should be marshalled for generated p/invokes
|
||||
</summary>
|
||||
</member>
|
||||
<member name="F:System.Runtime.InteropServices.StringMarshalling.Custom">
|
||||
<summary>
|
||||
Indicates the user is supplying a specific marshaller in <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType"/>.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="F:System.Runtime.InteropServices.StringMarshalling.Utf8">
|
||||
<summary>
|
||||
Use the platform-provided UTF-8 marshaller.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="F:System.Runtime.InteropServices.StringMarshalling.Utf16">
|
||||
<summary>
|
||||
Use the platform-provided UTF-16 marshaller.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.OSPlatformAttribute">
|
||||
<summary>
|
||||
Base type for all platform-specific API attributes.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.TargetPlatformAttribute">
|
||||
<summary>
|
||||
Records the platform that the project targeted.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.SupportedOSPlatformAttribute">
|
||||
<summary>
|
||||
Records the operating system (and minimum version) that supports an API. Multiple attributes can be
|
||||
applied to indicate support on multiple operating systems.
|
||||
</summary>
|
||||
<remarks>
|
||||
Callers can apply a <see cref="T:System.Runtime.Versioning.SupportedOSPlatformAttribute" />
|
||||
or use guards to prevent calls to APIs on unsupported operating systems.
|
||||
|
||||
A given platform should only be specified once.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.UnsupportedOSPlatformAttribute">
|
||||
<summary>
|
||||
Marks APIs that were removed in a given operating system version.
|
||||
</summary>
|
||||
<remarks>
|
||||
Primarily used by OS bindings to indicate APIs that are only available in
|
||||
earlier versions.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.ObsoletedOSPlatformAttribute">
|
||||
<summary>
|
||||
Marks APIs that were obsoleted in a given operating system version.
|
||||
</summary>
|
||||
<remarks>
|
||||
Primarily used by OS bindings to indicate APIs that should not be used anymore.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="M:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.#ctor(System.String)">
|
||||
<summary>
|
||||
Initializes a new instance of the <see cref="T:System.Runtime.Versioning.ObsoletedOSPlatformAttribute"/> class with the specified platform name.
|
||||
</summary>
|
||||
<param name="platformName">The name of the platform where the API was obsoleted.</param>
|
||||
</member>
|
||||
<member name="M:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.#ctor(System.String,System.String)">
|
||||
<summary>
|
||||
Initializes a new instance of the <see cref="T:System.Runtime.Versioning.ObsoletedOSPlatformAttribute"/> class with the specified platform name and message.
|
||||
</summary>
|
||||
<param name="platformName">The name of the platform where the API was obsoleted.</param>
|
||||
<param name="message">The message that explains the obsolescence.</param>
|
||||
</member>
|
||||
<member name="P:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.Message">
|
||||
<summary>
|
||||
Gets the message that explains the obsolescence.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="P:System.Runtime.Versioning.ObsoletedOSPlatformAttribute.Url">
|
||||
<summary>
|
||||
Gets or sets the URL that provides more information about the obsolescence.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.SupportedOSPlatformGuardAttribute">
|
||||
<summary>
|
||||
Annotates a custom guard field, property or method with a supported platform name and optional version.
|
||||
Multiple attributes can be applied to indicate guard for multiple supported platforms.
|
||||
</summary>
|
||||
<remarks>
|
||||
Callers can apply a <see cref="T:System.Runtime.Versioning.SupportedOSPlatformGuardAttribute" /> to a field, property or method
|
||||
and use that field, property or method in a conditional or assert statements in order to safely call platform specific APIs.
|
||||
|
||||
The type of the field or property should be boolean, the method return type should be boolean in order to be used as platform guard.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Runtime.Versioning.UnsupportedOSPlatformGuardAttribute">
|
||||
<summary>
|
||||
Annotates the custom guard field, property or method with an unsupported platform name and optional version.
|
||||
Multiple attributes can be applied to indicate guard for multiple unsupported platforms.
|
||||
</summary>
|
||||
<remarks>
|
||||
Callers can apply a <see cref="T:System.Runtime.Versioning.UnsupportedOSPlatformGuardAttribute" /> to a field, property or method
|
||||
and use that field, property or method in a conditional or assert statements as a guard to safely call APIs unsupported on those platforms.
|
||||
|
||||
The type of the field or property should be boolean, the method return type should be boolean in order to be used as platform guard.
|
||||
</remarks>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.AllowNullAttribute">
|
||||
<summary>Specifies that null is allowed as an input even if the corresponding type disallows it.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.DisallowNullAttribute">
|
||||
<summary>Specifies that null is disallowed as an input even if the corresponding type allows it.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MaybeNullAttribute">
|
||||
<summary>Specifies that an output may be null even if the corresponding type disallows it.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.NotNullAttribute">
|
||||
<summary>Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute">
|
||||
<summary>Specifies that when a method returns <see cref="P:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute.ReturnValue"/>, the parameter may be null even if the corresponding type disallows it.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute.#ctor(System.Boolean)">
|
||||
<summary>Initializes the attribute with the specified return value condition.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated parameter may be null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MaybeNullWhenAttribute.ReturnValue">
|
||||
<summary>Gets the return value condition.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute">
|
||||
<summary>Specifies that when a method returns <see cref="P:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute.ReturnValue"/>, the parameter will not be null even if the corresponding type allows it.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute.#ctor(System.Boolean)">
|
||||
<summary>Initializes the attribute with the specified return value condition.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated parameter will not be null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.NotNullWhenAttribute.ReturnValue">
|
||||
<summary>Gets the return value condition.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute">
|
||||
<summary>Specifies that the output will be non-null if the named parameter is non-null.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute.#ctor(System.String)">
|
||||
<summary>Initializes the attribute with the associated parameter name.</summary>
|
||||
<param name="parameterName">
|
||||
The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute.ParameterName">
|
||||
<summary>Gets the associated parameter name.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.DoesNotReturnAttribute">
|
||||
<summary>Applied to a method that will never return under any circumstance.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute">
|
||||
<summary>Specifies that the method will not return if the associated Boolean parameter is passed the specified value.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute.#ctor(System.Boolean)">
|
||||
<summary>Initializes the attribute with the specified parameter value.</summary>
|
||||
<param name="parameterValue">
|
||||
The condition parameter value. Code after the method will be considered unreachable by diagnostics if the argument to
|
||||
the associated parameter matches this value.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute.ParameterValue">
|
||||
<summary>Gets the condition parameter value.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute">
|
||||
<summary>Specifies that the method or property will ensure that the listed field and property members have not-null values.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute.#ctor(System.String)">
|
||||
<summary>Initializes the attribute with a field or property member.</summary>
|
||||
<param name="member">
|
||||
The field or property member that is promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute.#ctor(System.String[])">
|
||||
<summary>Initializes the attribute with the list of field and property members.</summary>
|
||||
<param name="members">
|
||||
The list of field and property members that are promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MemberNotNullAttribute.Members">
|
||||
<summary>Gets field or property member names.</summary>
|
||||
</member>
|
||||
<member name="T:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute">
|
||||
<summary>Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition.</summary>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.#ctor(System.Boolean,System.String)">
|
||||
<summary>Initializes the attribute with the specified return value condition and a field or property member.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated field or property member will not be null.
|
||||
</param>
|
||||
<param name="member">
|
||||
The field or property member that is promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="M:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.#ctor(System.Boolean,System.String[])">
|
||||
<summary>Initializes the attribute with the specified return value condition and list of field and property members.</summary>
|
||||
<param name="returnValue">
|
||||
The return value condition. If the method returns this value, the associated field and property members will not be null.
|
||||
</param>
|
||||
<param name="members">
|
||||
The list of field and property members that are promised to be not-null.
|
||||
</param>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.ReturnValue">
|
||||
<summary>Gets the return value condition.</summary>
|
||||
</member>
|
||||
<member name="P:System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute.Members">
|
||||
<summary>Gets field or property member names.</summary>
|
||||
</member>
|
||||
<member name="T:System.ExceptionPolyfills">
|
||||
<summary>Provides downlevel polyfills for static methods on Exception-derived types.</summary>
|
||||
</member>
|
||||
</members>
|
||||
</doc>
|
||||
Binary file not shown.
@@ -0,0 +1 @@
|
||||
V8UifCosNAmlKVDQRZ3WAN2BRaq6KWlaMq8IYTYMk/3x3AbcmdODPtfhbk5k9yePBOiE+jYaa/Gnde41xXjytQ==
|
||||
Reference in New Issue
Block a user