FileSecurity コンストラクター

定義

FileSecurity クラスの新しいインスタンスを初期化します。

オーバーロード

FileSecurity()

FileSecurity クラスの新しいインスタンスを初期化します。

FileSecurity(String, AccessControlSections)

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

FileSecurity()

FileSecurity クラスの新しいインスタンスを初期化します。

public FileSecurity ();

例外

現在のオペレーティング システムが Microsoft Windows 2000 以降ではありません。

注釈

既存のファイルに基づいていない空の FileSecurity オブジェクトを作成する場合は、このコンストラクターを使用します。 その後、オブジェクトにアクセス制御情報を設定し、ファイルに適用できます。

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

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5

FileSecurity(String, AccessControlSections)

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

public FileSecurity (string fileName, System.Security.AccessControl.AccessControlSections includeSections);

パラメーター

fileName
String

FileSecurity オブジェクトを作成するファイルの場所。

includeSections
AccessControlSections

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

例外

fileName パラメーターは、長さ 0 の文字列、空白のみを含む、または InvalidPathCharsで定義されている無効な文字を 1 つ以上含みます。

指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。

fileName パラメーターに指定されたファイルが見つかりませんでした。

ファイルを開くときに I/O エラーが発生しました。

path が無効な形式です。

fileName パラメーターは nullです。

現在のオペレーティング システムが Microsoft Windows 2000 以降ではありません。

指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。

現在のシステム アカウントには管理者特権がありません。

ファイルが見つかりませんでした。

fileName パラメーターは、読み取り専用のファイルを指定しました。

-又は-

この操作は、現在のプラットフォームではサポートされていません。

-又は-

fileName パラメーターでディレクトリが指定されました。

-又は-

呼び出し元に必要なアクセス許可がありません。

注釈

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

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

注意 (呼び出し元)

FileSecurity(String, AccessControlSections) コンストラクターでは、現在のアカウントに管理者特権が必要です。 管理特権のないアカウントを使用して、特定のファイルの FileSecurity クラスの新しいインスタンスを作成するには、GetAccessControl() メソッドを使用します。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5