FileSecurity コンストラクター

定義

名前空間:

System.Security.AccessControl

アセンブリ:

System.IO.FileSystem.AccessControl.dll

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

オーバーロード

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

FileSecurity()

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

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

例外

PlatformNotSupportedException

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

注釈

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

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

FileSecurity(String, AccessControlSections)

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

public:
 FileSecurity(System::String ^ fileName, System::Security::AccessControl::AccessControlSections includeSections);

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

new System.Security.AccessControl.FileSecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

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

パラメーター

fileName

String

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

includeSections

AccessControlSections

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

例外

ArgumentException

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

DirectoryNotFoundException

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

FileNotFoundException

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

IOException

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

NotSupportedException

path が無効な形式です。

SEHException

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

PlatformNotSupportedException

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

PathTooLongException

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

PrivilegeNotHeldException

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

SystemException

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

UnauthorizedAccessException

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

-又は-

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

-又は-

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

-又は-

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

注釈

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

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

注意 (呼び出し元)

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