FileSystemAccessRule Construtores

Definição

Inicializa uma nova instância da classe FileSystemAccessRule.Initializes a new instance of the FileSystemAccessRule class.

Sobrecargas

FileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)

Inicializa uma nova instância da classe FileSystemAccessRule usando uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso e um valor que especifica se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using a reference to a user account, a value that specifies the type of operation associated with the access rule, and a value that specifies whether to allow or deny the operation.

FileSystemAccessRule(String, FileSystemRights, AccessControlType)

Inicializa uma nova instância da classe FileSystemAccessRule usando o nome de uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso e um valor que descreve se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using the name of a user account, a value that specifies the type of operation associated with the access rule, and a value that describes whether to allow or deny the operation.

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

Inicializa uma nova instância da classe FileSystemAccessRule usando uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using a reference to a user account, a value that specifies the type of operation associated with the access rule, a value that determines how rights are inherited, a value that determines how rights are propagated, and a value that specifies whether to allow or deny the operation.

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

Inicializa uma nova instância da classe FileSystemAccessRule usando um nome de uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using the name of a user account, a value that specifies the type of operation associated with the access rule, a value that determines how rights are inherited, a value that determines how rights are propagated, and a value that specifies whether to allow or deny the operation.

FileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)

Inicializa uma nova instância da classe FileSystemAccessRule usando uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso e um valor que especifica se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using a reference to a user account, a value that specifies the type of operation associated with the access rule, and a value that specifies whether to allow or deny the operation.

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)

Parâmetros

identity
IdentityReference

Um objeto IdentityReference que encapsula uma referência a uma conta de usuário.An IdentityReference object that encapsulates a reference to a user account.

fileSystemRights
FileSystemRights

Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de acesso.One of the FileSystemRights values that specifies the type of operation associated with the access rule.

type
AccessControlType

Um dos valores de AccessControlType que especifica se a operação será permitida ou negada.One of the AccessControlType values that specifies whether to allow or deny the operation.

Exceções

O parâmetro identity não é um objeto IdentityReference.The identity parameter is not an IdentityReference object.

O parâmetro identity é null.The identity parameter is null.

Uma enumeração incorreta foi passada para o parâmetro type.An incorrect enumeration was passed to the type parameter.

Comentários

Use este construtor para criar uma regra de controle de acesso que você pode persistir usando a FileSecurity DirectorySecurity classe ou.Use this constructor to create an access control rule that you can persist using the FileSecurity or DirectorySecurity class. As regras de controle de acesso definem direitos de conta de usuário que determinam quais ações são permitidas ou não autorizadas em computadores que executam o Microsoft Windows.Access control rules define user account rights that determine which actions are allowed or disallowed on computers running Microsoft Windows.

Aplica-se a

FileSystemAccessRule(String, FileSystemRights, AccessControlType)

Inicializa uma nova instância da classe FileSystemAccessRule usando o nome de uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso e um valor que descreve se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using the name of a user account, a value that specifies the type of operation associated with the access rule, and a value that describes whether to allow or deny the operation.

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)

Parâmetros

identity
String

O nome de uma conta de usuário.The name of a user account.

fileSystemRights
FileSystemRights

Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de acesso.One of the FileSystemRights values that specifies the type of operation associated with the access rule.

type
AccessControlType

Um dos valores de AccessControlType que especifica se a operação será permitida ou negada.One of the AccessControlType values that specifies whether to allow or deny the operation.

Exceções

O parâmetro identity é null.The identity parameter is null.

Uma enumeração incorreta foi passada para o parâmetro type.An incorrect enumeration was passed to the type parameter.

Exemplos

O exemplo de código a seguir usa a FileSecurity classe para adicionar e, em seguida, remover uma entrada de controle de acesso (ACE) de um arquivo.The following code example uses the FileSecurity class to add and then remove an access control entry (ACE) from a file. Você deve fornecer uma conta de grupo ou de usuário válida para executar este exemplo.You must supply a valid user or group account to run this example.

using namespace System;
using namespace System::IO;
using namespace System::Security::AccessControl;

// Adds an ACL entry on the specified file for the specified account.

void AddFileSecurity(String^ fileName, String^ account, 
                        FileSystemRights rights, AccessControlType controlType)
{
    // Get a FileSecurity object that represents the 
    // current security settings.
    FileSecurity^ fSecurity = File::GetAccessControl(fileName);

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

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

// Removes an ACL entry on the specified file for the specified account.

void RemoveFileSecurity(String^ fileName, String^ account, 
                        FileSystemRights rights, AccessControlType controlType)
{

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

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

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

int main()
{
    try
    {
        String^ fileName = "test.xml";

        Console::WriteLine("Adding access control entry for " + fileName);

        // Add the access control entry to the file.
        AddFileSecurity(fileName, "MYDOMAIN\\MyAccount", 
            FileSystemRights::ReadData, AccessControlType::Allow);

        Console::WriteLine("Removing access control entry from " + fileName);

        // Remove the access control entry from the file.
        RemoveFileSecurity(fileName, "MYDOMAIN\\MyAccount", 
            FileSystemRights::ReadData, AccessControlType::Allow);

        Console::WriteLine("Done.");
    }
    catch (Exception^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

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)
        {

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

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

            // Set the new access settings.
            File.SetAccessControl(fileName, 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)
        {

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

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

            // 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.
            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)
  
        ' Get a FileSecurity object that represents the 
        ' current security settings.
        Dim fSecurity As FileSecurity = File.GetAccessControl(fileName)

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

        fSecurity.AddAccessRule(accessRule)

        ' Set the new access settings.
        File.SetAccessControl(fileName, 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)

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

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

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

    End Sub
End Module

Comentários

Use este construtor para criar uma regra de controle de acesso que você pode persistir usando a FileSecurity DirectorySecurity classe ou.Use this constructor to create an access control rule that you can persist using the FileSecurity or DirectorySecurity class. As regras de controle de acesso definem direitos de conta de usuário que determinam quais ações são permitidas ou não autorizadas em computadores que executam o Microsoft Windows.Access control rules define user account rights that determine which actions are allowed or disallowed on computers running Microsoft Windows.

O identity parâmetro deve identificar uma conta válida no computador ou domínio atual.The identity parameter must identify a valid account on the current computer or domain. A cadeia de caracteres usa o seguinte formulário, em que DOMAIN é o nome de um domínio ou nome de computador válido e account é o nome de uma conta de usuário válida em um domínio ou computador: DOMAIN\account .The string takes the following form, where DOMAIN is the name of a valid domain or computer name and account is the name of a valid user account on a domain or computer: DOMAIN\account.

Aplica-se a

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

Inicializa uma nova instância da classe FileSystemAccessRule usando uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using a reference to a user account, a value that specifies the type of operation associated with the access rule, a value that determines how rights are inherited, a value that determines how rights are propagated, and a value that specifies whether to allow or deny the operation.

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)

Parâmetros

identity
IdentityReference

Um objeto IdentityReference que encapsula uma referência a uma conta de usuário.An IdentityReference object that encapsulates a reference to a user account.

fileSystemRights
FileSystemRights

Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de acesso.One of the FileSystemRights values that specifies the type of operation associated with the access rule.

inheritanceFlags
InheritanceFlags

Um dos valores InheritanceFlags que especificam como as máscaras de acesso são propagadas para objetos filho.One of the InheritanceFlags values that specifies how access masks are propagated to child objects.

propagationFlags
PropagationFlags

Um dos valores PropagationFlags que especificam como as ACEs (Entradas de Controle de Acesso) são propagadas para objetos filho.One of the PropagationFlags values that specifies how Access Control Entries (ACEs) are propagated to child objects.

type
AccessControlType

Um dos valores de AccessControlType que especifica se a operação será permitida ou negada.One of the AccessControlType values that specifies whether to allow or deny the operation.

Exceções

O parâmetro identity não é um objeto IdentityReference.The identity parameter is not an IdentityReference object.

O parâmetro identity é null.The identity parameter is null.

Uma enumeração incorreta foi passada para o parâmetro type.An incorrect enumeration was passed to the type parameter.

- ou --or- Uma enumeração incorreta foi passada para o parâmetro inheritanceFlags.An incorrect enumeration was passed to the inheritanceFlags parameter.

- ou --or- Uma enumeração incorreta foi passada para o parâmetro propagationFlags.An incorrect enumeration was passed to the propagationFlags parameter.

Comentários

Use este construtor para criar uma regra de controle de acesso que você pode persistir usando a FileSecurity DirectorySecurity classe ou.Use this constructor to create an access control rule that you can persist using the FileSecurity or DirectorySecurity class. As regras de controle de acesso definem direitos de conta de usuário que determinam quais ações são permitidas ou não autorizadas em computadores que executam o Microsoft Windows.Access control rules define user account rights that determine which actions are allowed or disallowed on computers running Microsoft Windows.

Aplica-se a

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

Inicializa uma nova instância da classe FileSystemAccessRule usando um nome de uma conta de usuário, um valor que especifica o tipo de operação associado à regra de acesso, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica se a operação será permitida ou negada.Initializes a new instance of the FileSystemAccessRule class using the name of a user account, a value that specifies the type of operation associated with the access rule, a value that determines how rights are inherited, a value that determines how rights are propagated, and a value that specifies whether to allow or deny the operation.

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)

Parâmetros

identity
String

O nome de uma conta de usuário.The name of a user account.

fileSystemRights
FileSystemRights

Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de acesso.One of the FileSystemRights values that specifies the type of operation associated with the access rule.

inheritanceFlags
InheritanceFlags

Um dos valores InheritanceFlags que especificam como as máscaras de acesso são propagadas para objetos filho.One of the InheritanceFlags values that specifies how access masks are propagated to child objects.

propagationFlags
PropagationFlags

Um dos valores PropagationFlags que especificam como as ACEs (Entradas de Controle de Acesso) são propagadas para objetos filho.One of the PropagationFlags values that specifies how Access Control Entries (ACEs) are propagated to child objects.

type
AccessControlType

Um dos valores de AccessControlType que especifica se a operação será permitida ou negada.One of the AccessControlType values that specifies whether to allow or deny the operation.

Exceções

O parâmetro identity é null.The identity parameter is null.

Uma enumeração incorreta foi passada para o parâmetro type.An incorrect enumeration was passed to the type parameter.

- ou --or- Uma enumeração incorreta foi passada para o parâmetro inheritanceFlags.An incorrect enumeration was passed to the inheritanceFlags parameter.

- ou --or- Uma enumeração incorreta foi passada para o parâmetro propagationFlags.An incorrect enumeration was passed to the propagationFlags parameter.

Comentários

Use este construtor para criar uma regra de controle de acesso que você pode persistir usando a FileSecurity DirectorySecurity classe ou.Use this constructor to create an access control rule that you can persist using the FileSecurity or DirectorySecurity class. As regras de controle de acesso definem direitos de conta de usuário que determinam quais ações são permitidas ou não autorizadas em computadores que executam o Microsoft Windows.Access control rules define user account rights that determine which actions are allowed or disallowed on computers running Microsoft Windows.

O identity parâmetro deve identificar uma conta válida no computador ou domínio atual.The identity parameter must identify a valid account on the current computer or domain. A cadeia de caracteres usa o seguinte formulário, em que DOMAIN é o nome de um domínio ou nome de computador válido e account é o nome de uma conta de usuário válida em um domínio ou computador: DOMAIN\account .The string takes the following form, where DOMAIN is the name of a valid domain or computer name and account is the name of a valid user account on a domain or computer: DOMAIN\account.

Aplica-se a