FileStream.SetAccessControl メソッド

.NET Framework クラス ライブラリ リファレンス

FileStream.SetAccessControl メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

FileSecurity オブジェクトが示すアクセス制御リスト (ACL) エントリを、現在の FileStream オブジェクトが示すファイルに適用します。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub SetAccessControl ( _
    fileSecurity As FileSecurity _
)

Visual Basic (使用法)

Dim instance As FileStream
Dim fileSecurity As FileSecurity

instance.SetAccessControl(fileSecurity)

C#

public void SetAccessControl (
    FileSecurity fileSecurity
)

C++

public:
void SetAccessControl (
    FileSecurity^ fileSecurity
)

J#

public void SetAccessControl (
    FileSecurity fileSecurity
)

JScript

public function SetAccessControl (
    fileSecurity : FileSecurity
)

パラメータ

fileSecurity

現在のファイルに適用する ACL エントリを示す FileSecurity オブジェクト。

例外

例外の種類	条件
ObjectDisposedException	ファイルが閉じています。
ArgumentNullException	fileSecurity パラメータが null 参照 (Visual Basic では Nothing) です。
SystemException	ファイルが見つからないか、または変更されています。
UnauthorizedAccessException	現在のプロセスには、ファイルを開くために必要なアクセス権がありません。

解説

FileStream クラスと SetAccessControl は既存のファイルに対して使用できますが、より簡単に使用できる File.SetAccessControl メソッドを使用することを検討してください。

SetAccessControl メソッドは、非継承 ACL リストを表すファイルにアクセス制御リスト (ACL) エントリを適用します。

注意
ファイルの既存の ACL が、fileSecurity パラメータで指定された ACL と置き換えられます。新しいユーザーのアクセス許可を追加するには、GetAccessControl メソッドを使用して既存の ACL を取得し、これを変更します。次に、SetAccessControl を使用して、変更した ACL をファイルに適用します。

ACL は、指定したファイルに対して特定のアクションを実行する権限を持つ (または持たない) 個人およびグループ、またはそのいずれかを示します。詳細については、アクセス制御リスト (ACL: Access Control List) 技術の概要、方法 : アクセス制御リスト エントリを追加または削除する の各トピックを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FileStream クラス
FileStream メンバ
System.IO 名前空間