FileInfo.SetAccessControl(FileSecurity) メソッド

定義

名前空間:

System.IO

アセンブリ:

mscorlib.dll

FileSecurity オブジェクトによって記述されたアクセス制御リスト (ACL) エントリを、現在の FileInfo オブジェクトによって記述されたファイルに適用します。

C#

public void SetAccessControl(System.Security.AccessControl.FileSecurity fileSecurity);

パラメーター

fileSecurity

FileSecurity

現在のファイルに適用するアクセス制御リスト (ACL) エントリを記述する FileSecurity オブジェクト。

例外

ArgumentNullException

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

SystemException

ファイルが見つからないか、変更されませんでした。

UnauthorizedAccessException

現在のプロセスには、ファイルを開くアクセス権がありません。

例

次のコード例では、GetAccessControl メソッドと SetAccessControl メソッドを使用して、ACL エントリをファイルに追加して削除します。 この例を実行するには、有効なユーザーまたはグループ アカウントを指定する必要があります。

C#

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

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                string FileName = "c:/test.xml";

                Console.WriteLine("Adding access control entry for " + FileName);

                // Add the access control entry to the file.
                // Before compiling this snippet, change MyDomain to your
                // domain name and MyAccessAccount to the name
                // you use to access your domain.
                AddFileSecurity(FileName, @"MyDomain\MyAccessAccount", FileSystemRights.ReadData, AccessControlType.Allow);

                Console.WriteLine("Removing access control entry from " + FileName);

                // Remove the access control entry from the file.
                // Before compiling this snippet, change MyDomain to your
                // domain name and MyAccessAccount to the name
                // you use to access your domain.
                RemoveFileSecurity(FileName, @"MyDomain\MyAccessAccount", 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
            )
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new(FileName);

            // Get a FileSecurity object that represents the
            // current security settings.
            FileSecurity fSecurity = fInfo.GetAccessControl();

            // Add the FileSystemAccessRule to the security settings.
            fSecurity.AddAccessRule(new FileSystemAccessRule(Account,
                                                            Rights,
                                                            ControlType));

            // Set the new access settings.
            fInfo.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
            )
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new(FileName);

            // Get a FileSecurity object that represents the
            // current security settings.
            FileSecurity fSecurity = fInfo.GetAccessControl();

            // Add the FileSystemAccessRule to the security settings.
            fSecurity.RemoveAccessRule(new FileSystemAccessRule(Account,
                                                            Rights,
                                                            ControlType));

            // Set the new access settings.
            fInfo.SetAccessControl(fSecurity);
        }
    }
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//Adding access control entry for c:\test.xml
//Removing access control entry from c:\test.xml
//Done.
//

注釈

SetAccessControl メソッドは、アクセス制御リスト (ACL) エントリを、非暗号化 ACL リストを表す現在のファイルに適用します。

ファイルに ACL エントリを追加または削除する必要がある場合は常に、SetAccessControl メソッドを使用します。

注意事項

fileSecurity パラメーターに指定された ACL は、ファイルの既存の ACL を置き換えます。 新しいユーザーのアクセス許可を追加するには、GetAccessControl メソッドを使用して既存の ACL を取得し、変更してから、SetAccessControl を使用してファイルに適用します。

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

SetAccessControl メソッドは、オブジェクトの作成後に変更された FileSecurity オブジェクトのみを保持します。 FileSecurity オブジェクトが変更されていない場合、そのオブジェクトはファイルに永続化されません。 そのため、あるファイルから FileSecurity オブジェクトを取得し、同じオブジェクトを別のファイルに再適用することはできません。

ACL 情報をあるファイルから別のファイルにコピーするには:

1. GetAccessControl メソッドを使用して、ソース ファイルから FileSecurity オブジェクトを取得します。

2. コピー先ファイルの新しい FileSecurity オブジェクトを作成します。

3. ACL 情報を取得するには、ソース FileSecurity オブジェクトの GetSecurityDescriptorBinaryForm または GetSecurityDescriptorSddlForm メソッドを使用します。

4. SetSecurityDescriptorBinaryForm または SetSecurityDescriptorSddlForm メソッドを使用して、手順 3 で取得した情報をコピー先の FileSecurity オブジェクトにコピーします。

5. SetAccessControl メソッドを使用して、コピー先 FileSecurity オブジェクトをコピー先ファイルに設定します。

適用対象