FileStream.SetAccessControl(FileSecurity) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將物件描述 FileSecurity 的存取控制清單(ACL)條目套用到目前 FileStream 物件所描述的檔案上。
public:
void SetAccessControl(System::Security::AccessControl::FileSecurity ^ fileSecurity);
public void SetAccessControl(System.Security.AccessControl.FileSecurity fileSecurity);
member this.SetAccessControl : System.Security.AccessControl.FileSecurity -> unit
Public Sub SetAccessControl (fileSecurity As FileSecurity)
參數
- fileSecurity
- FileSecurity
一個描述 ACL 項目以套用到當前檔案的物件。
例外狀況
檔案已結案。
參數 fileSecurity 為 null。
該檔案無法被找到或修改。
目前的程序無法開啟該檔案。
備註
雖然 FileStream 類別 和 SetAccessControl 可以用在現有檔案上,但建議用這個 FileInfo.SetAccessControl 方法,因為比較容易使用。
此 SetAccessControl 方法將存取控制清單(ACL)條目套用到代表非繼承 ACL 清單的檔案。
注意事項
參數所指定的 fileSecurity ACL 會取代該檔案現有的 ACL。 要為新使用者新增權限,請使用 GetAccessControl 取得現有 ACL 的方法,修改它,然後 SetAccessControl 再套用回檔案。
ACL 描述了在特定檔案上擁有或不擁有特定行動權利的個人與團體。 如需詳細資訊,請參閱 如何:新增或移除存取控制清單項目。