Directory.GetAccessControl メソッド

定義

名前空間:

System.IO

アセンブリ:

mscorlib.dll

ディレクトリの Windows アクセス制御リスト (ACL) を返します。

オーバーロード

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

GetAccessControl(String)

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

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

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

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

Public Shared Function GetAccessControl (path As String) As DirectorySecurity

パラメーター

path

String

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

戻り値

DirectorySecurity

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

例外

ArgumentNullException

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

IOException

ディレクトリを開くときに I/O エラーが発生しました。

SystemException

ディレクトリが見つからないなど、システム レベルのエラーが発生しました。 特定の例外は、SystemExceptionのサブクラスである可能性があります。

UnauthorizedAccessException

path パラメーターは、読み取り専用のディレクトリを指定しました。

-又は-

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

-又は-

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

注釈

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

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

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

GetAccessControl(String, AccessControlSections)

指定したディレクトリの指定した種類のアクセス制御リスト (ACL) エントリをカプセル化する DirectorySecurity オブジェクトを取得します。

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

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

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

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

パラメーター

path

String

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

includeSections

AccessControlSections

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

戻り値

DirectorySecurity

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

例外

ArgumentNullException

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

IOException

ディレクトリを開くときに I/O エラーが発生しました。

SystemException

ディレクトリが見つからないなど、システム レベルのエラーが発生しました。 特定の例外は、SystemExceptionのサブクラスである可能性があります。

UnauthorizedAccessException

path パラメーターは、読み取り専用のディレクトリを指定しました。

-又は-

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

-又は-

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

注釈

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

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

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