FileSecurity コンストラクタとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

FileSecurity コンストラクタ (String, AccessControlSections)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

AccessControlSections 列挙体の値を指定して、指定したファイルの FileSecurity クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    fileName As String, _
    includeSections As AccessControlSections _
)

Visual Basic (使用法)

Dim fileName As String
Dim includeSections As AccessControlSections

Dim instance As New FileSecurity(fileName,
 includeSections)

public FileSecurity (
    string fileName,
    AccessControlSections includeSections
)

C++

public:
FileSecurity (
    String^ fileName, 
    AccessControlSections includeSections
)

public FileSecurity (
    String fileName, 
    AccessControlSections includeSections
)

JScript

public function FileSecurity (
    fileName : String, 
    includeSections : AccessControlSections
)

パラメータ

fileName: FileSecurity オブジェクトの作成元ファイルの場所。

includeSections: 取得するアクセス制御リスト (ACL) 情報の種類を指定する AccessControlSections 値の 1 つ。

例外

例外の種類	条件
ArgumentException	fileName パラメータが、長さが 0 の文字列であるか、空白しか含んでいないか、または InvalidPathChars で定義されている無効な文字を 1 つ以上含んでいます。
DirectoryNotFoundException	指定したパスが無効です (割り当てられていないドライブであるなど)。
FileNotFoundException	fileName パラメータで指定されたファイルが見つかりませんでした。
IOException	ファイルを開くときに、I/O エラーが発生しました。
NotSupportedException	path の形式が無効です。
SEHException	fileName パラメータが null 参照 (Visual Basic では Nothing) です。
PlatformNotSupportedException	現在のオペレーティングシステムは Microsoft Windows 2000 以降ではありません。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
PrivilegeNotHeldException	現在のシステムアカウントには、管理者特権がありません。
SystemException	ファイルが見つかりませんでした。
UnauthorizedAccessException	fileName パラメータによって、読み取り専用のファイルが指定されました。またはこの操作は、現在のプラットフォームではサポートされていません。または fileName パラメータはディレクトリを指定しました。または呼び出し元に、必要なアクセス許可がありません。

解説

このコンストラクタは、指定したファイルのアクセス制御情報を取得し、その情報をカプセル化する FileSecurity オブジェクトを作成します。作成後には、指定したファイルのアクセス制御情報を検査、追加、または削除できます。

AddAccessRule メソッドを使用すると、アクセス規則または監査規則を FileSecurity オブジェクトに追加できます。アクセス規則や監査規則を削除するには、RemoveAccessRule メソッドを使用します。

ファイルに対する新規または変更済みのアクセス規則や監査規則を保持するには、SetAccessControl メソッドまたは SetAccessControl メソッドを使用します。既存のファイルからアクセス規則または監査規則を取得するには、GetAccessControl メソッドまたは GetAccessControl メソッドを使用します。

呼び出し時の注意 FileSecurity コンストラクタを使用するには、現在のアカウントに管理者特権が必要です。管理者特権のないアカウントを使用して、特定のファイルに対する FileSecurity クラスの新しいインスタンスを作成するには、FileStream.GetAccessControl メソッドを使用します。

.NET Framework のセキュリティ

FileIOPermission (name パラメータで指定したファイルにアクセスするために必要なアクセス許可)。関連する列挙体 : NoAccess、View 要求 (セキュリティアクション)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FileSecurity クラス
FileSecurity メンバ
System.Security.AccessControl 名前空間

FileSecurity コンストラクタ

FileSecurity クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
FileSecurity ()	FileSecurity クラスの新しいインスタンスを初期化します。
FileSecurity (String, AccessControlSections)	AccessControlSections 列挙体の値を指定して、指定したファイルの FileSecurity クラスの新しいインスタンスを初期化します。