DirectorySecurity 建構函式

定義

命名空間:

System.Security.AccessControl

組件:

System.IO.FileSystem.AccessControl.dll

初始化 DirectorySecurity 類別的新執行個體。

多載

DirectorySecurity()	初始化 DirectorySecurity 類別的新執行個體。
DirectorySecurity(String, AccessControlSections)	使用 DirectorySecurity 列舉型別 (Enumeration) 之指定的值，從指定的目錄初始化 AccessControlSections 類別的新執行個體。

DirectorySecurity()

初始化 DirectorySecurity 類別的新執行個體。

public:
 DirectorySecurity();

public DirectorySecurity ();

Public Sub New ()

例外狀況

PlatformNotSupportedException

目前的作業系統不是 Microsoft Windows 2000 (含) 以後版本。

備註

當您想要建立不是以現有目錄為基礎的空 DirectorySecurity 物件時，請使用這個建構函式。 然後，您可以使用存取控制資訊填入物件，並將其套用至目錄。

DirectorySecurity(String, AccessControlSections)

使用 DirectorySecurity 列舉型別 (Enumeration) 之指定的值，從指定的目錄初始化 AccessControlSections 類別的新執行個體。

public:
 DirectorySecurity(System::String ^ name, System::Security::AccessControl::AccessControlSections includeSections);

public DirectorySecurity (string name, System.Security.AccessControl.AccessControlSections includeSections);

new System.Security.AccessControl.DirectorySecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.DirectorySecurity

Public Sub New (name As String, includeSections As AccessControlSections)

參數

name

String

從其中建立 DirectorySecurity 物件之目錄的位置。

includeSections

AccessControlSections

其中一個 AccessControlSections 值，指定要擷取之存取控制清單 (ACL) 資訊的類型。

例外狀況

ArgumentException

name 參數為零長度字串，只包含空格或包含一或多個由 InvalidPathChars 所定義的無效字元。

ArgumentNullException

name 參數為 null。

DirectoryNotFoundException

指定的路徑無效 (例如，它位於未對應的磁碟機上)。

FileNotFoundException

找不到 name 參數中指定的檔案。

IOException

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

NotSupportedException

name 參數的格式無效。

PlatformNotSupportedException

目前的作業系統不是 Microsoft Windows 2000 (含) 以後版本。

PathTooLongException

指定的路徑、檔案名稱，或兩者都超出系統定義的長度上限。

PrivilegeNotHeldException

目前的系統帳戶沒有系統管理權限。

SystemException

找不到此目錄。

UnauthorizedAccessException

name 參數指定了唯讀的目錄。

-或-

這個作業在目前平台不受支援。

-或-

呼叫端沒有必要的權限。

備註

這個建構函式會擷取指定目錄的存取控制資訊，然後建立 DirectorySecurity 封裝該資訊的 物件。 然後，您可以檢查、新增或刪除指定目錄的存取控制資訊。