File.GetAccessControl 方法

定義

命名空間:

System.IO

組件:

mscorlib.dll

取得 FileSecurity 對象，這個物件會封裝指定檔案的訪問控制清單 （ACL） 專案。

多載

GetAccessControl(String, AccessControlSections)	取得 FileSecurity 物件，該物件會封裝特定檔案的指定訪問控制清單 （ACL） 項目類型。
GetAccessControl(String)	取得 FileSecurity 對象，這個物件會封裝指定檔案的訪問控制清單 （ACL） 專案。

GetAccessControl(String, AccessControlSections)

取得 FileSecurity 物件，該物件會封裝特定檔案的指定訪問控制清單 （ACL） 項目類型。

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);

static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

參數

path

String

檔案的路徑，其中包含描述檔案訪問控制清單 （ACL） 資訊的 FileSecurity 物件。

includeSections

AccessControlSections

其中一個 AccessControlSections 值，指定要接收的訪問控制清單 （ACL） 信息類型。

傳回

FileSecurity

FileSecurity 物件，封裝 path 參數所描述檔案的訪問控制規則。

例外狀況

IOException

開啟檔案時發生 I/O 錯誤。

SEHException

path 參數是 null。

SystemException

找不到檔案。

UnauthorizedAccessException

path 參數指定了唯讀的檔案。

-或-

目前平臺不支援此作業。

-或-

path 參數指定目錄。

-或-

呼叫端沒有必要的許可權。

備註

使用 GetAccessControl 方法來擷取檔案的訪問控制清單 （ACL） 專案。

ACL 描述具有或沒有指定檔案上特定動作許可權的個人和群組。 如需詳細資訊，請參閱 如何：新增或移除存取控制清單項目。

在NTFS環境中，如果使用者在父資料夾具有 ListDirectory 許可權，則會將 ReadAttributes 和 ReadExtendedAttributes 授與使用者。 若要拒絕 ReadAttributes 和 ReadExtendedAttributes，請拒絕父目錄上的 ListDirectory。

GetAccessControl(String)

取得 FileSecurity 對象，這個物件會封裝指定檔案的訪問控制清單 （ACL） 專案。

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path);

static member GetAccessControl : string -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String) As FileSecurity

參數

path

String

檔案的路徑，其中包含描述檔案訪問控制清單 （ACL） 資訊的 FileSecurity 物件。

傳回

FileSecurity

FileSecurity 物件，封裝 path 參數所描述檔案的訪問控制規則。

例外狀況

IOException

開啟檔案時發生 I/O 錯誤。

SEHException

path 參數是 null。

SystemException

找不到檔案。

UnauthorizedAccessException

path 參數指定了唯讀的檔案。

-或-

目前平臺不支援此作業。

-或-

path 參數指定目錄。

-或-

呼叫端沒有必要的許可權。

備註

使用 GetAccessControl 方法來擷取檔案的訪問控制清單 （ACL） 專案。

ACL 描述具有或沒有指定檔案上特定動作許可權的個人和群組。 如需詳細資訊，請參閱 如何：新增或移除存取控制清單項目。

在NTFS環境中，如果使用者在父資料夾具有 ListDirectory 許可權，則會將 ReadAttributes 和 ReadExtendedAttributes 授與使用者。 若要拒絕 ReadAttributes 和 ReadExtendedAttributes，請拒絕父目錄上的 ListDirectory。