FileStream.SetAccessControl(FileSecurity) メソッド


FileSecurity オブジェクトが示すアクセス制御リスト (ACL) エントリを、現在の FileStream オブジェクトが示すファイルに適用します。Applies access control list (ACL) entries described by a FileSecurity object to the file described by the current FileStream object.

 void SetAccessControl(System::Security::AccessControl::FileSecurity ^ fileSecurity);
public void SetAccessControl (System.Security.AccessControl.FileSecurity fileSecurity);
member this.SetAccessControl : System.Security.AccessControl.FileSecurity -> unit



現在のファイルに適用する ACL エントリを示すオブジェクト。An object that describes an ACL entry to apply to the current file.


ファイルは閉じられています。The file is closed.

fileSecurity パラメーターが null です。The fileSecurity parameter is null.

ファイルを検出または変更できませんでした。The file could not be found or modified.

現在のプロセスには、ファイルを開くために必要なアクセス権がありません。The current process does not have access to open the file.


FileStream クラスと SetAccessControl は既存のファイルで使用できますが、使用しやすいように File.SetAccessControl メソッドを使用することを検討してください。While the FileStream class and SetAccessControl can be used on an existing file, consider using the File.SetAccessControl method as it is easier to use.

SetAccessControl メソッドは、継承されていない ACL リストを表すファイルにアクセス制御リスト (ACL) エントリを適用します。The SetAccessControl method applies access control list (ACL) entries to a file that represents the noninherited ACL list.


fileSecurity パラメーターに指定された ACL は、ファイルの既存の ACL を置き換えます。The ACL specified for the fileSecurity parameter replaces the existing ACL for the file. 新しいユーザーにアクセス許可を追加するには、GetAccessControl メソッドを使用して既存の ACL を取得し、変更した後、SetAccessControl を使用してファイルに再度適用します。To add permissions for a new user, use the GetAccessControl method to obtain the existing ACL, modify it, and then use SetAccessControl to apply it back to the file.

ACL は、特定のファイルに対する特定のアクションに対する権限を持っている、または所有していない個人やグループを記述します。An ACL describes individuals and/or groups who have, or do not have, rights to specific actions on the given file. 詳細については、「方法: アクセス制御リスト エントリを追加または削除する」を参照してください。For more information, see How to: Add or Remove Access Control List Entries.