FileSystemSecurity.SetAccessRule(FileSystemAccessRule) 方法

定義

命名空間:

System.Security.AccessControl

組件:

System.IO.FileSystem.AccessControl.dll

設定目前檔案或目錄之指定的存取控制清單 (ACL) 使用權限。

public:
 void SetAccessRule(System::Security::AccessControl::FileSystemAccessRule ^ rule);

public void SetAccessRule (System.Security.AccessControl.FileSystemAccessRule rule);

override this.SetAccessRule : System.Security.AccessControl.FileSystemAccessRule -> unit

Public Sub SetAccessRule (rule As FileSystemAccessRule)

參數

rule

FileSystemAccessRule

FileSystemAccessRule 物件，表示要為檔案或目錄設定的存取控制清單 (ACL) 使用權限。

例外狀況

ArgumentNullException

rule 參數為 null。

備註

方法 SetAccessRule 會將指定的存取控制清單新增 (ACL) 規則，或覆寫符合 FileSystemRights 參數值 rule 的任何相同 ACL 規則。 例如，如果 rule 參數指定 Read 值，而且 SetAccessRule 方法會尋找指定值的相同 ACL 規則 Read ，則會覆寫相同的規則。 SetAccessRule如果方法找到指定 Write 值的相同 ACL 規則，將不會覆寫相同的規則。

若要將新的或變更的 ACL 資訊保存到檔案，請使用 SetAccessControl 或 SetAccessControl 方法。 若要將新的或變更的 ACL 資訊保存到目錄，請使用 SetAccessControl 或 SetAccessControl 方法。

若要從檔案擷取 ACL 資訊，請使用 GetAccessControl 或 GetAccessControl 方法。 若要從目錄擷取 ACL 資訊，請使用 GetAccessControl 或 GetAccessControl 方法。