FileStream.GetAccessControl Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a FileSecurity object that encapsulates the access control list (ACL) entries for the file described by the current FileStream object.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public FileSecurity GetAccessControl()

Return Value

Type: System.Security.AccessControl.FileSecurity

An object that encapsulates the access control settings for the file described by the current FileStream object.

Exception Condition
ObjectDisposedException

The file is closed.

IOException

An I/O error occurred while opening the file.

SystemException

The file could not be found.

UnauthorizedAccessException

This operation is not supported on the current platform.

-or-

The caller does not have the required permission.

While the FileStream class and GetAccessControl can be used to retrieve the access control list (ACL) entries of an existing file, consider using File.GetAccessControl method, as it is easier to use.

Use the GetAccessControl method to retrieve the ACL entries for a file.

An ACL describes individuals and/or groups who have, or do not have, rights to specific actions on the given file. For more information, see How to: Add or Remove Access Control List Entries.

.NET Framework
Available since 2.0
Return to top
Show: