FileSecurity 建構函式

定義

命名空間:

System.Security.AccessControl

組件:

System.IO.FileSystem.AccessControl.dll

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

多載

名稱	Description
FileSecurity()	初始化 FileSecurity 類別的新執行個體。
FileSecurity(String, AccessControlSections)	利用列舉的指定值FileSecurity，從指定檔案初始化該類別的新實例AccessControlSections。

FileSecurity()

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

public:
 FileSecurity();

public FileSecurity();

Public Sub New ()

例外狀況

PlatformNotSupportedException

目前的作業系統並非Microsoft Windows 2000年或之後。

備註

當你想建立一個非基於現有檔案的空 FileSecurity 物件時，可以使用這個建構器。 接著你可以將存取控制資訊填入物件，並將其套用到檔案中。

你可以用這個FileSecurity方法為物件新增存取或稽核規則AddAccessRule。 你可以用這個 RemoveAccessRule 方法移除存取或稽核規則。

FileSecurity(String, AccessControlSections)

利用列舉的指定值FileSecurity，從指定檔案初始化該類別的新實例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 方法移除存取或稽核規則。

給呼叫者的注意事項

FileSecurity(String, AccessControlSections)建構者要求活期帳戶擁有管理權限。 若要使用沒有管理員權限的帳號為特定檔案建立新實例 FileSecurity ，請使用以下 GetAccessControl() 方法。