File.GetAccessControl 方法

定義

命名空間:: System.IO

組件:: mscorlib.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得 FileSecurity 一個物件，封裝指定檔案的存取控制清單（ACL）條目。

多載

名稱	Description
GetAccessControl(String)	取得 FileSecurity 一個物件，封裝指定檔案的存取控制清單（ACL）條目。
GetAccessControl(String, AccessControlSections)	取得 FileSecurity 一個物件，封裝特定檔案的存取控制清單（ACL）條目。

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

指向包含 FileSecurity 描述該檔案存取控制清單（ACL）資訊物件的檔案路徑。

傳回

FileSecurity

一個 FileSecurity 封裝由 path 參數描述的檔案存取控制規則的物件。

例外狀況

IOException

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

SEHException

參數 path 為 null。

SystemException

該檔案找不到。

UnauthorizedAccessException

該 path 參數指定一個唯讀的檔案。

-或-

目前平臺不支援此作業。

-或-

該 path 參數指定了一個目錄。

-或-

來電者沒有所需的權限。

備註

使用此 GetAccessControl 方法取得檔案的存取控制清單（ACL）條目。

ACL 描述了在特定檔案上擁有或不擁有特定行動權利的個人與團體。如需詳細資訊，請參閱如何：新增或移除存取控制清單項目。

在 NTFS 環境中， ReadAttributes 若 ReadExtendedAttributes 使用者擁有 ListDirectory 父資料夾的權限，則會授予使用者。在父目錄中拒絕ReadAttributes ReadExtendedAttributes和，拒絕ListDirectory。

適用於

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