FileSystems.GetFileSystem(URI) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns a reference to an existing FileSystem
.
[Android.Runtime.Register("getFileSystem", "(Ljava/net/URI;)Ljava/nio/file/FileSystem;", "", ApiSince=26)]
public static Java.Nio.FileNio.FileSystem? GetFileSystem (Java.Net.URI? uri);
[<Android.Runtime.Register("getFileSystem", "(Ljava/net/URI;)Ljava/nio/file/FileSystem;", "", ApiSince=26)>]
static member GetFileSystem : Java.Net.URI -> Java.Nio.FileNio.FileSystem
Parameters
- uri
- URI
the URI to locate the file system
Returns
the reference to the file system
- Attributes
Remarks
Returns a reference to an existing FileSystem
.
This method iterates over the FileSystemProvider#installedProviders() installed
providers to locate the provider that is identified by the URI URI#getScheme scheme
of the given URI. URI schemes are compared without regard to case. The exact form of the URI is highly provider dependent. If found, the provider's FileSystemProvider#getFileSystem getFileSystem
method is invoked to obtain a reference to the FileSystem
.
Once a file system created by this provider is FileSystem#close closed
it is provider-dependent if this method returns a reference to the closed file system or throws FileSystemNotFoundException
. If the provider allows a new file system to be created with the same URI as a file system it previously created then this method throws the exception if invoked after the file system is closed (and before a new instance is created by the #newFileSystem newFileSystem
method).
If a security manager is installed then a provider implementation may require to check a permission before returning a reference to an existing file system. In the case of the FileSystems#getDefault default
file system, no permission check is required.
Java documentation for java.nio.file.FileSystems.getFileSystem(java.net.URI)
.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.