File.GetAccessControl メソッド

定義

名前空間:

System.IO

アセンブリ:

mscorlib.dll

指定したファイルのアクセス制御リスト (ACL) エントリをカプセル化する FileSecurity オブジェクトを取得します。

オーバーロード

GetAccessControl(String)	指定したファイルのアクセス制御リスト (ACL) エントリをカプセル化する FileSecurity オブジェクトを取得します。
GetAccessControl(String, AccessControlSections)	特定のファイルの指定した種類のアクセス制御リスト (ACL) エントリをカプセル化する FileSecurity オブジェクトを取得します。

GetAccessControl(String)

指定したファイルのアクセス制御リスト (ACL) エントリをカプセル化する FileSecurity オブジェクトを取得します。

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path);

static member GetAccessControl : string -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String) As FileSecurity

パラメーター

path

String

ファイルのアクセス制御リスト (ACL) 情報を記述する FileSecurity オブジェクトを含むファイルへのパス。

戻り値

FileSecurity

path パラメーターによって記述されたファイルのアクセス制御規則をカプセル化する FileSecurity オブジェクト。

例外

IOException

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

SEHException

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

SystemException

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

UnauthorizedAccessException

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

-又は-

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

-又は-

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

-又は-

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

注釈

GetAccessControl メソッドを使用して、ファイルのアクセス制御リスト (ACL) エントリを取得します。

ACL は、特定のファイルに対する特定のアクションに対する権限を持っている(または持っていない)個人とグループを表します。 詳細については、「方法: アクセス制御リスト エントリ追加または削除する」を参照してください。

NTFS 環境では、ユーザーが親フォルダーに対する ListDirectory 権限を持っている場合、ReadAttributes と ReadExtendedAttributes がユーザーに付与されます。 ReadAttributes と ReadExtendedAttributesを拒否するには、親ディレクトリの ListDirectory を拒否します。

GetAccessControl(String, AccessControlSections)

特定のファイルの指定した種類のアクセス制御リスト (ACL) エントリをカプセル化する FileSecurity オブジェクトを取得します。

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);

static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

パラメーター

path

String

ファイルのアクセス制御リスト (ACL) 情報を記述する FileSecurity オブジェクトを含むファイルへのパス。

includeSections

AccessControlSections

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

戻り値

FileSecurity

path パラメーターによって記述されたファイルのアクセス制御規則をカプセル化する FileSecurity オブジェクト。

例外

IOException

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

SEHException

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

SystemException

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

UnauthorizedAccessException

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

-又は-

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

-又は-

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

-又は-

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

注釈

GetAccessControl メソッドを使用して、ファイルのアクセス制御リスト (ACL) エントリを取得します。

ACL は、特定のファイルに対する特定のアクションに対する権限を持っている(または持っていない)個人とグループを表します。 詳細については、「方法: アクセス制御リスト エントリ追加または削除する」を参照してください。

NTFS 環境では、ユーザーが親フォルダーに対する ListDirectory 権限を持っている場合、ReadAttributes と ReadExtendedAttributes がユーザーに付与されます。 ReadAttributes と ReadExtendedAttributesを拒否するには、親ディレクトリの ListDirectory を拒否します。