Directory.GetAccessControl 方法

定義

命名空間:

System.IO

組件:

mscorlib.dll

傳回目錄的 Windows 訪問控制清單 （ACL）。

多載

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

GetAccessControl(String)

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

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

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

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

Public Shared Function GetAccessControl (path As String) As DirectorySecurity

參數

path

String

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

傳回

DirectorySecurity

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

例外狀況

ArgumentNullException

path 參數是 null。

IOException

開啟目錄時發生 I/O 錯誤。

SystemException

發生系統層級錯誤，例如找不到目錄。 特定例外狀況可能是 SystemException的子類別。

UnauthorizedAccessException

path 參數指定了唯讀目錄。

-或-

目前平臺不支援此作業。

-或-

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

備註

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

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

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

GetAccessControl(String, AccessControlSections)

取得 DirectorySecurity 物件，這個物件會封裝指定目錄的指定訪問控制清單 （ACL） 項目類型。

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

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

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

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

參數

path

String

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

includeSections

AccessControlSections

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

傳回

DirectorySecurity

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

例外狀況

ArgumentNullException

path 參數是 null。

IOException

開啟目錄時發生 I/O 錯誤。

SystemException

發生系統層級錯誤，例如找不到目錄。 特定例外狀況可能是 SystemException的子類別。

UnauthorizedAccessException

path 參數指定了唯讀目錄。

-或-

目前平臺不支援此作業。

-或-

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

備註

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

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

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