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

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

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

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

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

AccessControlSections 列挙体の値を指定して、指定したディレクトリの DirectorySecurity クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim name As String
Dim includeSections As AccessControlSections

Dim instance As New DirectorySecurity(name,
 includeSections)

public DirectorySecurity (
    string name,
    AccessControlSections includeSections
)

C++

public:
DirectorySecurity (
    String^ name, 
    AccessControlSections includeSections
)

public DirectorySecurity (
    String name, 
    AccessControlSections includeSections
)

JScript

public function DirectorySecurity (
    name : String, 
    includeSections : AccessControlSections
)

パラメータ

name: DirectorySecurity オブジェクトの作成元ディレクトリの場所。

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

例外

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

解説

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

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

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

.NET Framework のセキュリティ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

DirectorySecurity コンストラクタ

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

名前	説明
DirectorySecurity ()	DirectorySecurity クラスの新しいインスタンスを初期化します。
DirectorySecurity (String, AccessControlSections)	AccessControlSections 列挙体の値を指定して、指定したディレクトリの DirectorySecurity クラスの新しいインスタンスを初期化します。