FileSecurity 建構函式

定義

命名空間:

System.Security.AccessControl

組件:

System.IO.FileSystem.AccessControl.dll

初始化 FileSecurity 類別的新實例。

多載

FileSecurity()	初始化 FileSecurity 類別的新實例。
FileSecurity(String, AccessControlSections)	使用 AccessControlSections 列舉的指定值，從指定的檔案初始化 FileSecurity 類別的新實例。

FileSecurity()

初始化 FileSecurity 類別的新實例。

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

例外狀況

PlatformNotSupportedException

目前的操作系統不會Microsoft Windows 2000 或更新版本。

備註

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

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

FileSecurity(String, AccessControlSections)

使用 AccessControlSections 列舉的指定值，從指定的檔案初始化 FileSecurity 類別的新實例。

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 物件。 然後，您可以檢查、新增或刪除指定檔案的訪問控制資訊。

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

給呼叫者的注意事項

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