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 描述具有或沒有指定檔案上特定動作許可權的個人和群組。 如需詳細資訊,請參閱 如何:新增或移除存取控制清單項目。