FileIOPermission Класс

Определение

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

Наследование

Object

CodeAccessPermission

FileIOPermission

Атрибуты

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Реализации

IUnrestrictedPermission

Примеры

В следующих примерах показан код, использующий FileIOPermission. После следующих двух строк кода объект f представляет разрешение на чтение всех файлов на локальных дисках клиентского компьютера. Затем в примере кода требуется разрешение, чтобы определить, имеет ли приложение разрешение на чтение файлов.

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

После следующих двух строк кода объект f2 представляет разрешения на чтение C:\test_r, а также чтение и запись в C:\example\out.txt. Read и Write представляют разрешения для файлов и папок, как описано выше. После создания разрешения код требует разрешения, чтобы определить, имеет ли приложение право на чтение и запись в файл.

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

Комментарии

Это разрешение различает следующие четыре типа доступа к файлу ввода-вывода, предоставляемые FileIOPermissionAccess:

• Read: чтение доступа к содержимому файла или доступа к сведениям о файле, например его длине или времени последнего изменения.

• Write: запись доступа к содержимому файла или для изменения сведений о файле, например его имени. Также позволяет удалять и перезаписывать.

• Append: возможность записи только в конец файла. Нет возможности чтения.

• PathDiscovery: доступ к информации в самом пути. Это помогает защитить конфиденциальную информацию в пути, например имена пользователей, а также сведения о структуре каталогов, отображаемой в пути. Это значение не предоставляет доступа к файлам и папкам, на которые указывает путь.

Все эти разрешения являются независимыми, а это означает, что права на один не подразумевают права на другой. Например, Write разрешение не подразумевает разрешения на Read или Append. Если необходимо несколько разрешений, их можно объединить с помощью побитового или, как показано в примере кода ниже. Разрешение файла определяется в терминах канонических абсолютных путей; Вызовы всегда должны выполняться с каноническими путями к файлам.

FileIOPermission описывает защищенные операции с файлами и папками. Класс File помогает обеспечить безопасный доступ к файлам и папкам. При создании дескриптора для файла выполняется проверка доступа к безопасности. При выполнении проверка во время создания влияние проверка безопасности на производительность сводится к минимуму. Открытие файла происходит один раз, а чтение и запись могут выполняться несколько раз. После открытия файла дальнейшие проверки не выполняются. Если объект передается ненадежной вызывающей объекту, его можно использовать неправильно. Например, дескрипторы файлов не должны храниться в общедоступных глобальных статических службах, где код с меньшими разрешениями может получить к ним доступ.

FileIOPermissionAccess указывает действия, которые могут выполняться с файлом или папкой. Кроме того, эти действия можно объединить с помощью побитового или для формирования сложных экземпляров.

Доступ к папке подразумевает доступ ко всем содержащимся в ней файлам, а также ко всем файлам и папкам во вложенных папках. Например, Read доступ к C:\folder1\ подразумевает Read доступ к C:\folder1\file1.txt, C:\folder1\folder2\, C:\folder1\folder2\file2.txt и т. д.

Конструкторы

Свойства

Методы

Применяется к

См. также раздел

• FileIOPermissionAccess
• FileIOPermissionAttribute