FileSystemAuditRule 构造函数

定义

命名空间:: System.Security.AccessControl

程序集:: System.IO.FileSystem.AccessControl.dll

程序集:: mscorlib.dll

包:: System.IO.FileSystem.AccessControl v5.0.0

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化 FileSystemAuditRule 类的新实例。

重载

名称	说明
FileSystemAuditRule(IdentityReference, FileSystemRights, AuditFlags)	使用对用户帐户的引用、指定与审核规则关联的操作类型的值以及指定何时执行审核的值初始化类的新实例 FileSystemAuditRule 。
FileSystemAuditRule(String, FileSystemRights, AuditFlags)	使用用户帐户名称初始化类的新实例 FileSystemAuditRule ，该值指定与审核规则关联的操作类型，以及指定何时执行审核的值。
FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)	使用对用户帐户的引用名称初始化类的新实例 FileSystemAuditRule ，该值指定与审核规则关联的操作类型、确定权限继承方式的值、确定权限传播方式的值以及指定何时执行审核的值。
FileSystemAuditRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)	使用用户帐户的名称初始化类的新实例 FileSystemAuditRule ，该值指定与审核规则关联的操作类型、确定权限继承方式的值、确定权限传播方式的值，以及指定何时执行审核的值。

FileSystemAuditRule(IdentityReference, FileSystemRights, AuditFlags)

使用对用户帐户的引用、指定与审核规则关联的操作类型的值以及指定何时执行审核的值初始化类的新实例 FileSystemAuditRule 。

public:
 FileSystemAuditRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AuditFlags flags);

public FileSystemAuditRule(System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AuditFlags flags);

new System.Security.AccessControl.FileSystemAuditRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule

Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, flags As AuditFlags)

参数

identity: IdentityReference

封装 IdentityReference 对用户帐户的引用的对象。

fileSystemRights: FileSystemRights

指定 FileSystemRights 与审核规则关联的操作类型的值之一。

flags: AuditFlags

指定 AuditFlags 何时执行审核的值之一。

例外

ArgumentException

参数 identity 不是 IdentityReference 对象。

ArgumentNullException

参数 identity 为 null.

ArgumentOutOfRangeException

向参数传递了 flags 不正确的枚举。

-或-

该值 None 传递给 flags 参数。

注解

使用此构造函数创建可以使用或FileSecurity类持久保存的DirectorySecurity审核规则。审核规则确定对系统对象（如文件和文件夹）执行的操作的记录时间和方式。

适用于

FileSystemAuditRule(String, FileSystemRights, AuditFlags)

使用用户帐户名称初始化类的新实例 FileSystemAuditRule ，该值指定与审核规则关联的操作类型，以及指定何时执行审核的值。

public:
 FileSystemAuditRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AuditFlags flags);

public FileSystemAuditRule(string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AuditFlags flags);

new System.Security.AccessControl.FileSystemAuditRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule

Public Sub New (identity As String, fileSystemRights As FileSystemRights, flags As AuditFlags)

参数

identity: String

用户帐户的名称。

fileSystemRights: FileSystemRights

指定 FileSystemRights 与审核规则关联的操作类型的值之一。

flags: AuditFlags

指定 AuditFlags 何时执行审核的值之一。

例外

ArgumentOutOfRangeException

向参数传递了 flags 不正确的枚举。

-或-

该值 None 传递给 flags 参数。

示例

下面的代码示例使用 FileSystemAuditRule 类添加并删除文件中的审核规则。必须提供有效的用户或组帐户才能运行此示例。

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.
                AddFileAuditRule(FileName, @"MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure);

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

                // Remove the access control entry from the file.
                RemoveFileAuditRule(FileName, @"MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure);

                Console.WriteLine("Done.");
            }
            catch (IOException e)
            {
                Console.WriteLine("Unable to open the file: " + e.Message);
            }
            catch (PrivilegeNotHeldException e)
            {
                Console.WriteLine("The current account does not have the correct privileges: " + e.Message);
            }

            Console.ReadLine();
        }

        // Adds an ACL entry on the specified file for the specified account.
        public static void AddFileAuditRule(string FileName, string Account, FileSystemRights Rights, AuditFlags AuditRule)
        {

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

            // Add the FileSystemAuditRule to the security settings.
            fSecurity.AddAuditRule(new FileSystemAuditRule(Account,
                                                            Rights,
                                                            AuditRule));

            // Set the new access settings.
            File.SetAccessControl(FileName, fSecurity);
        }

        // Removes an ACL entry on the specified file for the specified account.
        public static void RemoveFileAuditRule(string FileName, string Account, FileSystemRights Rights, AuditFlags AuditRule)
        {

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

            // Add the FileSystemAuditRule to the security settings.
            fSecurity.RemoveAuditRule(new FileSystemAuditRule(Account,
                                                            Rights,
                                                            AuditRule));

            // Set the new access settings.
            File.SetAccessControl(FileName, 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.
            AddFileAuditRule(FileName, "MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure)

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

            ' Remove the access control entry from the file.
            RemoveFileAuditRule(FileName, "MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure)

            Console.WriteLine("Done.")
        Catch e As IOException
            Console.WriteLine("Unable to open the file: " & e.Message)
        Catch e As PrivilegeNotHeldException
            Console.WriteLine("The current account does not have the correct privileges: " & e.Message)
        End Try

        Console.ReadLine()

    End Sub


    ' Adds an ACL entry on the specified file for the specified account.
    Sub AddFileAuditRule(ByVal FileName As String, ByVal Account As String, ByVal Rights As FileSystemRights, ByVal AuditRule As AuditFlags)


        ' Get a FileSecurity object that represents the 
        ' current security settings.
        Dim fSecurity As FileSecurity = File.GetAccessControl(FileName)

        ' Add the FileSystemAuditRule to the security settings. 
        fSecurity.AddAuditRule(New FileSystemAuditRule(Account, Rights, AuditRule))

        ' Set the new access settings.
        File.SetAccessControl(FileName, fSecurity)

    End Sub


    ' Removes an ACL entry on the specified file for the specified account.
    Sub RemoveFileAuditRule(ByVal FileName As String, ByVal Account As String, ByVal Rights As FileSystemRights, ByVal AuditRule As AuditFlags)

        ' Get a FileSecurity object that represents the 
        ' current security settings.
        Dim fSecurity As FileSecurity = File.GetAccessControl(FileName)

        ' Add the FileSystemAuditRule to the security settings. 
        fSecurity.RemoveAuditRule(New FileSystemAuditRule(Account, Rights, AuditRule))

        ' Set the new access settings.
        File.SetAccessControl(FileName, fSecurity)

    End Sub
End Module

注解

该 identity 参数必须标识当前计算机或域中的有效帐户。该字符串采用以下形式，其中DOMAIN有效域或计算机名称的名称是account域或计算机上的有效用户帐户的名称： DOMAIN\account

适用于

FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)

使用对用户帐户的引用名称初始化类的新实例 FileSystemAuditRule ，该值指定与审核规则关联的操作类型、确定权限继承方式的值、确定权限传播方式的值以及指定何时执行审核的值。

public:
 FileSystemAuditRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AuditFlags flags);

public FileSystemAuditRule(System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AuditFlags flags);

new System.Security.AccessControl.FileSystemAuditRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule

Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, flags As AuditFlags)

参数

identity: IdentityReference

封装 IdentityReference 对用户帐户的引用的对象。

fileSystemRights: FileSystemRights

指定 FileSystemRights 与审核规则关联的操作类型的值之一。

inheritanceFlags: InheritanceFlags

指定 InheritanceFlags 访问掩码如何传播到子对象的值之一。

propagationFlags: PropagationFlags

PropagationFlags 值之一，该值指定如何将访问控制项（ACE）传播到子对象。

flags: AuditFlags

指定 AuditFlags 何时执行审核的值之一。

例外

ArgumentException

参数 identity 不是 IdentityReference 对象。

ArgumentNullException

参数 identity 为 null.

ArgumentOutOfRangeException

向参数传递了 flags 不正确的枚举。

-或-

该值 None 传递给 flags 参数。

注解

适用于

FileSystemAuditRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)

使用用户帐户的名称初始化类的新实例 FileSystemAuditRule ，该值指定与审核规则关联的操作类型、确定权限继承方式的值、确定权限传播方式的值，以及指定何时执行审核的值。

public:
 FileSystemAuditRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AuditFlags flags);

public FileSystemAuditRule(string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AuditFlags flags);

new System.Security.AccessControl.FileSystemAuditRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule

Public Sub New (identity As String, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, flags As AuditFlags)

参数

identity: String

用户帐户的名称。

fileSystemRights: FileSystemRights

指定 FileSystemRights 与审核规则关联的操作类型的值之一。

inheritanceFlags: InheritanceFlags

指定 InheritanceFlags 访问掩码如何传播到子对象的值之一。

propagationFlags: PropagationFlags

PropagationFlags 值之一，该值指定如何将访问控制项（ACE）传播到子对象。

flags: AuditFlags

指定 AuditFlags 何时执行审核的值之一。

注解

适用于

反馈

此页面是否有帮助？