FileIOPermission Classe

Definição

public ref class FileIOPermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission

[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[System.Serializable]
public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

public sealed class FileIOPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

[<System.Serializable>]
type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

type FileIOPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

Public NotInheritable Class FileIOPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission

Herança

Object

CodeAccessPermission

FileIOPermission

Atributos

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implementações

IUnrestrictedPermission

Exemplos

Os exemplos a seguir ilustram o código que usa FileIOPermission. Após as duas linhas de código a seguir, o objeto f representa a permissão para ler todos os arquivos nos discos locais do computador cliente. Em seguida, o exemplo de código exige a permissão para determinar se o aplicativo tem permissão para ler os arquivos.

FileIOPermission^ f = gcnew FileIOPermission( PermissionState::None );
f->AllLocalFiles = FileIOPermissionAccess::Read;
try
{
    f->Demand();
}
catch (SecurityException^ s)
{
    Console::WriteLine(s->Message);
}

FileIOPermission f = new FileIOPermission(PermissionState.None);
f.AllLocalFiles = FileIOPermissionAccess.Read;
try
{
    f.Demand();
}
catch (SecurityException s)
{
    Console.WriteLine(s.Message);
}

Dim f As New FileIOPermission(PermissionState.None)
f.AllLocalFiles = FileIOPermissionAccess.Read
Try
    f.Demand()
Catch s As SecurityException
    Console.WriteLine(s.Message)
End Try

Após as duas linhas de código a seguir, o objeto f2 representa permissões para ler C:\test_r e ler e gravar em C:\example\out.txt. Read e Write representam as permissões de arquivo/pasta, conforme descrito anteriormente. Depois de criar a permissão, o código exige a permissão para determinar se o aplicativo tem o direito de ler e gravar no arquivo.

FileIOPermission^ f2 = gcnew FileIOPermission( FileIOPermissionAccess::Read,"C:\\test_r" );
f2->AddPathList( (FileIOPermissionAccess) (FileIOPermissionAccess::Write | FileIOPermissionAccess::Read), "C:\\example\\out.txt" );
try
{
    f2->Demand();
}
catch (SecurityException^ s)
{
    Console::WriteLine(s->Message);
}

FileIOPermission f2 = new FileIOPermission(FileIOPermissionAccess.Read, "C:\\test_r");
f2.AddPathList(FileIOPermissionAccess.Write | FileIOPermissionAccess.Read, "C:\\example\\out.txt");
try
{
    f2.Demand();
}
catch (SecurityException s)
{
    Console.WriteLine(s.Message);
}

Dim f2 As New FileIOPermission(FileIOPermissionAccess.Read, "C:\test_r")
f2.AddPathList(FileIOPermissionAccess.Write Or FileIOPermissionAccess.Read, "C:\example\out.txt")
Try
    f2.Demand()
Catch s As SecurityException
    Console.WriteLine(s.Message)
End Try

Comentários

Essa permissão distingue entre os quatro tipos de acesso de E/S de arquivo fornecidos por FileIOPermissionAccess:

• Read: acesso de leitura ao conteúdo do arquivo ou acesso a informações sobre o arquivo, como seu comprimento ou hora da última modificação.

• Write: acesso de gravação ao conteúdo do arquivo ou acesso para alterar informações sobre o arquivo, como seu nome. Também permite a exclusão e a substituição.

• Append: capacidade de gravar somente no final de um arquivo. Não há capacidade de ler.

• PathDiscovery: acesso às informações no próprio caminho. Isso ajuda a proteger informações confidenciais no caminho, como nomes de usuário, bem como informações sobre a estrutura de diretório que é revelada no caminho. Esse valor não concede acesso a arquivos ou pastas representadas pelo caminho.

Todas essas permissões são independentes, o que significa que os direitos de um não implicam direitos a outro. Por exemplo, Write a permissão não implica permissão para Read ou Append. Se mais de uma permissão for desejada, elas poderão ser combinadas usando um OR bit a bit, conforme mostrado no exemplo de código a seguir. A permissão de arquivo é definida em termos de caminhos absolutos canônicos; as chamadas sempre devem ser feitas com caminhos de arquivo canônicos.

FileIOPermission descreve operações protegidas em arquivos e pastas. A File classe ajuda a fornecer acesso seguro a arquivos e pastas. O marcar de acesso de segurança é executado quando o identificador para o arquivo é criado. Ao fazer o marcar no momento da criação, o impacto no desempenho da marcar de segurança é minimizado. Abrir um arquivo acontece uma vez, enquanto a leitura e a gravação podem ocorrer várias vezes. Depois que o arquivo for aberto, nenhuma verificação adicional será feita. Se o objeto for passado para um chamador não confiável, ele poderá ser usado incorretamente. Por exemplo, os identificadores de arquivo não devem ser armazenados em estáticas globais públicas em que o código com menos permissão possa acessá-los.

FileIOPermissionAccess especifica ações que podem ser executadas no arquivo ou pasta. Além disso, essas ações podem ser combinadas usando um OR bit a bit para formar instâncias complexas.

O acesso a uma pasta implica acesso a todos os arquivos que ela contém, bem como acesso a todos os arquivos e pastas em suas subpastas. Por exemplo, Read o acesso a C:\folder1\ implica Read acesso a C:\folder1\file1.txt, C:\folder1\folder2\, C:\folder1\folder2\file2.txt e assim por diante.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• FileIOPermissionAccess
• FileIOPermissionAttribute