FileSecurity コンストラクター

定義

名前空間:

System.Security.AccessControl

アセンブリ:

System.IO.FileSystem.AccessControl.dll

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

オーバーロード

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

FileSecurity()

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

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

例外

PlatformNotSupportedException

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

注釈

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

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

新しいアクセス規則または変更されたアクセス規則または監査規則をファイルに保持するには、 メソッドまたは SetAccessControl メソッドを使用しますSetAccessControl。 既存のファイルからアクセス規則または監査規則を取得するには、 メソッドまたは GetAccessControl メソッドをGetAccessControl使用します。

FileSecurity(String, AccessControlSections)

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

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 パラメーターは長さゼロの文字列で、空白のみで構成されているか、または InvalidPathChars で定義されるように 1 つ以上の無効な文字を含んでいます。

DirectoryNotFoundException

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

FileNotFoundException

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

IOException

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

NotSupportedException

path の形式が正しくありません。

SEHException

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

PlatformNotSupportedException

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

PathTooLongException

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

PrivilegeNotHeldException

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

SystemException

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

UnauthorizedAccessException

fileName パラメーターに読み取り専用のファイルが指定されています。

- または -

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

- または -

fileName パラメーターにディレクトリが指定されています。

- または -

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

注釈

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

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

新しいアクセス規則または変更されたアクセス規則または監査規則をファイルに保持するには、 メソッドまたは SetAccessControl メソッドを使用しますSetAccessControl。 既存のファイルからアクセス規則または監査規則を取得するには、 メソッドまたは GetAccessControl メソッドをGetAccessControl使用します。

注意 (呼び出し元)

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