FileSystemAccessRule コンストラクター

リファレンス

定義

名前空間:: System.Security.AccessControl

アセンブリ:: System.IO.FileSystem.AccessControl.dll

アセンブリ:: mscorlib.dll

パッケージ:: System.IO.FileSystem.AccessControl v5.0.0

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

FileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)	ユーザーアカウントへの参照、アクセス規則に関連付けられた操作の種類を指定する値、およびその操作を許可するか拒否するかを指定する値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。
FileSystemAccessRule(String, FileSystemRights, AccessControlType)	ユーザーアカウントの名前、アクセス規則に関連付けられた操作の種類を指定する値、およびその操作を許可するか拒否するかを示す値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。
FileSystemAccessRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)	ユーザーアカウントへの参照、アクセス規則に関連付けられた操作の種類を指定する値、権限の継承方法を決定する値、権限の反映方法を決定する値、および操作を許可するか拒否するかを指定する値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。
FileSystemAccessRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)	ユーザーアカウント名、アクセス規則に関連付けられた操作の種類を指定する値、権限の継承方法を決定する値、権限の反映方法を決定する値、および操作を許可するか拒否するかを指定する値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。

FileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)

ユーザーアカウントへの参照、アクセス規則に関連付けられた操作の種類を指定する値、およびその操作を許可するか拒否するかを指定する値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。

public:
 FileSystemAccessRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule (System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, type As AccessControlType)

パラメーター

identity: IdentityReference

ユーザーアカウントへの参照をカプセル化する IdentityReference オブジェクト。

fileSystemRights: FileSystemRights

アクセス規則に関連付けられた操作の種類を指定する FileSystemRights 値のいずれか。

type: AccessControlType

操作を許可するか拒否するかを指定する AccessControlType 値のいずれか。

例外

ArgumentException

identity パラメーターが IdentityReference オブジェクトではありません。

ArgumentNullException

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

ArgumentOutOfRangeException

type パラメーターに誤った列挙体が渡されました。

注釈

このコンストラクターを使用して、クラスまたは DirectorySecurity クラスを使用して永続化できるアクセス制御規則をFileSecurity作成します。アクセス制御規則では、Microsoft Windows を実行しているコンピューターで許可または禁止されるアクションを決定するユーザーアカウント権限を定義します。

適用対象

FileSystemAccessRule(String, FileSystemRights, AccessControlType)

ユーザーアカウントの名前、アクセス規則に関連付けられた操作の種類を指定する値、およびその操作を許可するか拒否するかを示す値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。

public:
 FileSystemAccessRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule (string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As String, fileSystemRights As FileSystemRights, type As AccessControlType)

パラメーター

identity: String

ユーザーアカウント名。

fileSystemRights: FileSystemRights

アクセス規則に関連付けられた操作の種類を指定する FileSystemRights 値のいずれか。

type: AccessControlType

操作を許可するか拒否するかを指定する AccessControlType 値のいずれか。

例外

ArgumentNullException

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

ArgumentOutOfRangeException

type パラメーターに誤った列挙体が渡されました。

例

次のコード例では、クラスを FileSecurity 使用して、ファイルにアクセス制御エントリ (ACE) を追加して削除します。この例を実行するには、有効なユーザーまたはグループアカウントを指定する必要があります。

using System;
using System.IO;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                string fileName = "test.xml";

                Console.WriteLine($"Adding access control entry for {fileName}");

                // Add the access control entry to the file.
                AddFileSecurity(fileName, @"DomainName\AccountName",
                    FileSystemRights.ReadData, AccessControlType.Allow);

                Console.WriteLine($"Removing access control entry from {fileName}");

                // Remove the access control entry from the file.
                RemoveFileSecurity(fileName, @"DomainName\AccountName",
                    FileSystemRights.ReadData, AccessControlType.Allow);

                Console.WriteLine("Done.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }
        }

        // Adds an ACL entry on the specified file for the specified account.
        public static void AddFileSecurity(string fileName, string account,
            FileSystemRights rights, AccessControlType controlType)
        {
            FileInfo fileInfo = new(fileName);
            FileSecurity fSecurity = fileInfo.GetAccessControl();

            // Add the FileSystemAccessRule to the security settings.
            fSecurity.AddAccessRule(new FileSystemAccessRule(account,
                rights, controlType));

            // Set the new access settings.
            fileInfo.SetAccessControl(fSecurity);
        }

        // Removes an ACL entry on the specified file for the specified account.
        public static void RemoveFileSecurity(string fileName, string account,
            FileSystemRights rights, AccessControlType controlType)
        {
            FileInfo fileInfo = new(fileName);
            FileSecurity fSecurity = fileInfo.GetAccessControl();

            // Remove the FileSystemAccessRule from the security settings.
            fSecurity.RemoveAccessRule(new FileSystemAccessRule(account,
                rights, controlType));

            // Set the new access settings.
            fileInfo.SetAccessControl(fSecurity);
        }
    }
}

Imports System.IO
Imports System.Security.AccessControl

Module FileExample

    Sub Main()
        Try
            Dim fileName As String = "test.xml"

            Console.WriteLine("Adding access control entry for " & fileName)

            ' Add the access control entry to the file.
            AddFileSecurity(fileName, "DomainName\AccountName",
                FileSystemRights.ReadData, AccessControlType.Allow)

            Console.WriteLine("Removing access control entry from " & fileName)

            ' Remove the access control entry from the file.
            RemoveFileSecurity(fileName, "DomainName\AccountName",
                FileSystemRights.ReadData, AccessControlType.Allow)

            Console.WriteLine("Done.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

    End Sub

    ' Adds an ACL entry on the specified file for the specified account.
    Sub AddFileSecurity(ByVal fileName As String, ByVal account As String,
        ByVal rights As FileSystemRights, ByVal controlType As AccessControlType)

        Dim fileInfo As New FileInfo(fileName)
        Dim fSecurity As FileSecurity = fileInfo.GetAccessControl()

        ' Add the FileSystemAccessRule to the security settings. 
        Dim accessRule As New FileSystemAccessRule(account, rights, controlType)

        fSecurity.AddAccessRule(accessRule)

        ' Set the new access settings.
        fileInfo.SetAccessControl(fSecurity)

    End Sub

    ' Removes an ACL entry on the specified file for the specified account.
    Sub RemoveFileSecurity(ByVal fileName As String, ByVal account As String,
        ByVal rights As FileSystemRights, ByVal controlType As AccessControlType)

        Dim fileInfo As New FileInfo(fileName)
        Dim fSecurity As FileSecurity = fileInfo.GetAccessControl()

        ' Remove the FileSystemAccessRule from the security settings. 
        fSecurity.RemoveAccessRule(New FileSystemAccessRule(account,
            rights, controlType))

        ' Set the new access settings.
        fileInfo.SetAccessControl(fSecurity)

    End Sub
End Module

注釈

パラメーターは identity 、現在のコンピューターまたはドメイン上の有効なアカウントを識別する必要があります。文字列は次の形式になります。ここでDOMAIN、は有効なドメインまたはコンピューター名の名前で、accountドメインまたはコンピューター上の有効なユーザーアカウントの名前です。 DOMAIN\account

適用対象

FileSystemAccessRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)

ユーザーアカウントへの参照、アクセス規則に関連付けられた操作の種類を指定する値、権限の継承方法を決定する値、権限の反映方法を決定する値、および操作を許可するか拒否するかを指定する値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。

public:
 FileSystemAccessRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule (System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, type As AccessControlType)

パラメーター

identity: IdentityReference

ユーザーアカウントへの参照をカプセル化する IdentityReference オブジェクト。

fileSystemRights: FileSystemRights

アクセス規則に関連付けられた操作の種類を指定する FileSystemRights 値のいずれか。

inheritanceFlags: InheritanceFlags

子オブジェクトにアクセスマスクを反映する方法を指定する InheritanceFlags 値のいずれか。

propagationFlags: PropagationFlags

子オブジェクトにアクセス制御エントリ (ACE) を反映する方法を指定する PropagationFlags 値のいずれか。

type: AccessControlType

操作を許可するか拒否するかを指定する AccessControlType 値のいずれか。

例外

ArgumentException

identity パラメーターが IdentityReference オブジェクトではありません。

ArgumentNullException

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

ArgumentOutOfRangeException

type パラメーターに誤った列挙体が渡されました。

- または -

inheritanceFlags パラメーターに誤った列挙体が渡されました。

- または -

propagationFlags パラメーターに誤った列挙体が渡されました。

注釈

適用対象

FileSystemAccessRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)

ユーザーアカウント名、アクセス規則に関連付けられた操作の種類を指定する値、権限の継承方法を決定する値、権限の反映方法を決定する値、および操作を許可するか拒否するかを指定する値を使用して、FileSystemAccessRule クラスの新しいインスタンスを初期化します。

public:
 FileSystemAccessRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule (string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As String, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, type As AccessControlType)

パラメーター

identity: String

ユーザーアカウント名。

fileSystemRights: FileSystemRights

アクセス規則に関連付けられた操作の種類を指定する FileSystemRights 値のいずれか。

inheritanceFlags: InheritanceFlags

子オブジェクトにアクセスマスクを反映する方法を指定する InheritanceFlags 値のいずれか。

propagationFlags: PropagationFlags

子オブジェクトにアクセス制御エントリ (ACE) を反映する方法を指定する PropagationFlags 値のいずれか。

type: AccessControlType

操作を許可するか拒否するかを指定する AccessControlType 値のいずれか。

例外

ArgumentNullException

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

ArgumentOutOfRangeException

type パラメーターに誤った列挙体が渡されました。

- または -

inheritanceFlags パラメーターに誤った列挙体が渡されました。

- または -

propagationFlags パラメーターに誤った列挙体が渡されました。

注釈

適用対象

次の方法で共有

FileSystemAccessRule コンストラクター

定義

オーバーロード

FileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)

パラメーター

例外

注釈

適用対象

FileSystemAccessRule(String, FileSystemRights, AccessControlType)

パラメーター

例外

例

注釈

適用対象

FileSystemAccessRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)

パラメーター

例外

注釈

適用対象

FileSystemAccessRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)

パラメーター

例外

注釈

適用対象

その他のリソース