FileSecurity 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 FileSecurity 類別的新執行個體。
多載
FileSecurity() |
初始化 FileSecurity 類別的新執行個體。 |
FileSecurity(String, AccessControlSections) |
使用 FileSecurity 列舉型別 (Enumeration) 之指定的值,從指定的檔案初始化 AccessControlSections 類別的新執行個體。 |
FileSecurity()
初始化 FileSecurity 類別的新執行個體。
public:
FileSecurity();
public FileSecurity ();
Public Sub New ()
例外狀況
目前的作業系統不是 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) 資訊的類型。
例外狀況
fileName
參數為零長度字串,只包含空格或包含一或多個由 InvalidPathChars 所定義的無效字元。
指定的路徑無效 (例如,它位於未對應的磁碟機上)。
找不到 fileName
參數中指定的檔案。
開啟檔案時發生 I/O 錯誤。
path
格式無效。
fileName
參數為 null
。
目前的作業系統不是 Microsoft Windows 2000 (含) 以後版本。
指定的路徑、檔案名稱,或兩者都超出系統定義的長度上限。
目前的系統帳戶沒有系統管理權限。
找不到檔案。
fileName
參數指定了唯讀的檔案。
-或-
這個作業在目前平台不受支援。
-或-
fileName
參數指定了目錄。
-或-
呼叫端沒有必要的權限。
備註
這個建構函式會擷取指定檔案的存取控制資訊,然後建立 FileSecurity 封裝該資訊的 物件。 然後,您可以檢查、新增或刪除指定檔案的存取控制資訊。
您可以使用 方法, FileSecurity 將存取或稽核規則新增至 物件 AddAccessRule 。 您可以使用 方法來移除存取或稽核 RemoveAccessRule 規則。
若要將新的或變更的存取或稽核規則保存到檔案,請使用 SetAccessControl 或 SetAccessControl 方法。 若要從現有的檔案擷取存取或稽核規則,請使用 GetAccessControl 或 GetAccessControl 方法。
給呼叫者的注意事項
建 FileSecurity(String, AccessControlSections) 構函式需要目前的帳戶具有系統管理許可權。 若要使用沒有系統管理許可權的 FileSecurity 帳戶,針對特定檔案建立 類別的新實例,請使用 GetAccessControl() 方法。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應