FileSecurity Construtores

Definição

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

Sobrecargas

FileSecurity()

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

FileSecurity(String, AccessControlSections)

Inicializa uma nova instância da classe FileSecurity de um arquivo especificado usando os valores especificados da enumeração AccessControlSections.Initializes a new instance of the FileSecurity class from a specified file using the specified values of the AccessControlSections enumeration.

FileSecurity()

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

public:
 FileSecurity();
public FileSecurity ();
Public Sub New ()

Exceções

O sistema operacional atual não é o Microsoft Windows 2000 ou posterior.The current operating system is not Microsoft Windows 2000 or later.

Comentários

Use esse construtor quando desejar criar um FileSecurity objeto vazio que não seja baseado em um arquivo existente.Use this constructor when you want to create an empty FileSecurity object that is not based on an existing file. Em seguida, você pode preencher o objeto com informações de controle de acesso e aplicá-lo a um arquivo.You can then populate the object with access control information and apply it to a file.

Você pode adicionar regras de acesso ou de auditoria ao FileSecurity objeto usando o AddAccessRule método.You can add access or audit rules to the FileSecurity object using the AddAccessRule method. Você pode remover o acesso ou as regras de auditoria usando o RemoveAccessRule método.You can remove access or audit rules using the RemoveAccessRule method.

Para manter as regras de acesso ou de auditoria novas ou alteradas para um arquivo, use o SetAccessControl SetAccessControl método ou.To persist new or changed access or audit rules to a file, use the SetAccessControl or SetAccessControl method. Para recuperar o acesso ou as regras de auditoria de um arquivo existente, use o GetAccessControl GetAccessControl método ou.To retrieve access or audit rules from an existing file, use the GetAccessControl or GetAccessControl method.

Aplica-se a

FileSecurity(String, AccessControlSections)

Inicializa uma nova instância da classe FileSecurity de um arquivo especificado usando os valores especificados da enumeração AccessControlSections.Initializes a new instance of the FileSecurity class from a specified file using the specified values of the AccessControlSections enumeration.

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)

Parâmetros

fileName
String

O local de um arquivo do qual criar um objeto FileSecurity.The location of a file to create a FileSecurity object from.

includeSections
AccessControlSections

Um dos valores AccessControlSections que especifica o tipo de informações da ACL (lista de controle de acesso) a serem recuperadas.One of the AccessControlSections values that specifies the type of access control list (ACL) information to retrieve.

Exceções

O parâmetro fileName é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.The fileName parameter is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).The specified path is invalid, (for example, it is on an unmapped drive).

O arquivo especificado no parâmetro fileName não foi encontrado.The file specified in the fileName parameter was not found.

Um erro de E/S ocorreu ao abrir o arquivo.An I/O error occurred while opening the file.

path está em um formato inválido.path is in an invalid format.

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

O sistema operacional atual não é o Microsoft Windows 2000 ou posterior.The current operating system is not Microsoft Windows 2000 or later.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.The specified path, file name, or both exceed the system-defined maximum length.

A conta do sistema atual não tem privilégios administrativos.The current system account does not have administrative privileges.

Não foi possível encontrar o arquivo.The file could not be found.

O parâmetro fileName especificou um arquivo somente leitura.The fileName parameter specified a file that is read-only.

- ou --or- Não há suporte para essa operação na plataforma atual.This operation is not supported on the current platform.

- ou --or- O parâmetro fileName especificou um diretório.The fileName parameter specified a directory.

- ou --or- O chamador não tem a permissão necessária.The caller does not have the required permission.

Comentários

Esse construtor recupera as informações de controle de acesso para o arquivo especificado e, em seguida, cria um FileSecurity objeto que encapsula essas informações.This constructor retrieves the access control information for the specified file and then creates a FileSecurity object that encapsulates that information. Você pode inspecionar, adicionar ou excluir as informações de controle de acesso para o arquivo especificado.You can then inspect, add, or delete the access control information for the specified file.

Você pode adicionar regras de acesso ou de auditoria ao FileSecurity objeto usando o AddAccessRule método.You can add access or audit rules to the FileSecurity object using the AddAccessRule method. Você pode remover o acesso ou as regras de auditoria usando o RemoveAccessRule método.You can remove access or audit rules using the RemoveAccessRule method.

Para manter as regras de acesso ou de auditoria novas ou alteradas para um arquivo, use o SetAccessControl SetAccessControl método ou.To persist new or changed access or audit rules to a file, use the SetAccessControl or SetAccessControl method. Para recuperar o acesso ou as regras de auditoria de um arquivo existente, use o GetAccessControl GetAccessControl método ou.To retrieve access or audit rules from an existing file, use the GetAccessControl or GetAccessControl method.

Notas aos Chamadores

O FileSecurity(String, AccessControlSections) construtor requer que a conta atual tenha privilégios administrativos.The FileSecurity(String, AccessControlSections) constructor requires the current account to have administrative privileges. Para criar uma nova instância da FileSecurity classe para um arquivo específico usando uma conta que não tem privilégios administrativos, use o GetAccessControl() método.To create a new instance of the FileSecurity class for a specific file using an account that does not have administrative privileges, use the GetAccessControl() method.

Aplica-se a