FileSecurity 建構函式

定義

命名空間:

System.Security.AccessControl

組件:

System.IO.FileSystem.AccessControl.dll

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

多載

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

FileSecurity()

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

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

例外狀況

PlatformNotSupportedException

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

備註

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

您可以使用 方法， FileSecurity 將存取或稽核規則新增至 物件 AddAccessRule 。 您可以使用 方法來移除存取或稽核 RemoveAccessRule 規則。

若要將新的或變更的存取或稽核規則保存到檔案，請使用 SetAccessControl 或 SetAccessControl 方法。 若要從現有的檔案擷取存取或稽核規則，請使用 GetAccessControl 或 GetAccessControl 方法。

FileSecurity(String, AccessControlSections)

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

public:
 FileSecurity(System::String ^ fileName, System::Security::AccessControl::AccessControlSections includeSections);

public FileSecurity (string fileName, System.Security.AccessControl.AccessControlSections includeSections);

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

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

參數

fileName

String

從其中建立 FileSecurity 物件之檔案的位置。

includeSections

AccessControlSections

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

例外狀況

ArgumentException

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

DirectoryNotFoundException

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

FileNotFoundException

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

IOException

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

NotSupportedException

path 格式無效。

SEHException

fileName 參數為 null。

PlatformNotSupportedException

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

PathTooLongException

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

PrivilegeNotHeldException

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

SystemException

找不到檔案。

UnauthorizedAccessException

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

-或-

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

-或-

fileName 參數指定了目錄。

-或-

呼叫端沒有必要的權限。

備註

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

您可以使用 方法， FileSecurity 將存取或稽核規則新增至 物件 AddAccessRule 。 您可以使用 方法來移除存取或稽核 RemoveAccessRule 規則。

若要將新的或變更的存取或稽核規則保存到檔案，請使用 SetAccessControl 或 SetAccessControl 方法。 若要從現有的檔案擷取存取或稽核規則，請使用 GetAccessControl 或 GetAccessControl 方法。

給呼叫者的注意事項

建 FileSecurity(String, AccessControlSections) 構函式需要目前的帳戶具有系統管理許可權。 若要使用沒有系統管理許可權的 FileSecurity 帳戶，針對特定檔案建立 類別的新實例，請使用 GetAccessControl() 方法。