FileIOPermission Třída

Definice

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

Dědičnost

Object

CodeAccessPermission

FileIOPermission

Atributy

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implementuje

IUnrestrictedPermission

Příklady

Následující příklady znázorňují kód, který používá FileIOPermission. Za následujícími dvěma řádky kódu objekt f představuje oprávnění ke čtení všech souborů na místních discích klientského počítače. Příklad kódu pak vyžaduje oprávnění k určení, zda má aplikace oprávnění číst soubory.

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

Za následujícími dvěma řádky kódu objekt f2 představuje oprávnění ke čtení C:\test_r a čtení a zápisu do C:\example\out.txt. Read a Write představují oprávnění k souboru nebo složce, jak je popsáno výše. Po vytvoření oprávnění vyžaduje kód oprávnění k určení, jestli má aplikace právo číst a zapisovat do souboru.

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

Poznámky

Toto oprávnění rozlišuje mezi následujícími čtyřmi typy přístupu ke vstupně-výstupním operacím souborů, které FileIOPermissionAccessposkytuje :

• Read: Přístup ke čtení obsahu souboru nebo přístup k informacím o souboru, jako je jeho délka nebo čas poslední úpravy.

• Write: Zápis přístupu k obsahu souboru nebo přístup ke změně informací o souboru, například jeho názvu. Umožňuje také odstranění a přepsání.

• Append: Možnost zápisu pouze na konec souboru. Žádná schopnost číst.

• PathDiscovery: Přístup k informacím v samotné cestě. To pomáhá chránit citlivé informace v cestě, jako jsou uživatelská jména, a také informace o adresářové struktuře, které se v cestě objeví. Tato hodnota neuděluje přístup k souborům nebo složkám reprezentovaným cestou.

Všechna tato oprávnění jsou nezávislá, což znamená, že práva k jednomu neznamenají práva jiného. Oprávnění například Write neznamená oprávnění k Read nebo Append. Pokud je potřeba více než jedno oprávnění, můžete je zkombinovat pomocí bitové hodnoty OR, jak je znázorněno v následujícím příkladu kódu. Oprávnění k souboru je definováno z hlediska kanonických absolutních cest; volání by vždy měla být provedena s kanonickými cestami k souborům.

FileIOPermission popisuje chráněné operace se soubory a složkami. Třída File pomáhá zajistit zabezpečený přístup k souborům a složkám. Kontrola přístupu zabezpečení se provádí při vytvoření popisovače souboru. Provedením kontroly při vytváření se minimalizuje dopad kontroly zabezpečení na výkon. Otevření souboru se provede jednou, zatímco čtení a zápis může proběhnout několikrát. Po otevření souboru se neprokonají žádné další kontroly. Pokud je objekt předán nedůvěryhodnému volajícímu, může být zneužit. Například popisovače souborů by neměly být uložené ve veřejných globálních statických objektech, kde k nim může přistupovat kód s menším oprávněním.

FileIOPermissionAccess určuje akce, které lze provést se souborem nebo složkou. Kromě toho je možné tyto akce kombinovat pomocí bitové funkce OR a vytvořit tak složité instance.

Přístup ke složce znamená přístup ke všem souborům, které obsahuje, a také přístup ke všem souborům a složkám v jejích podsložkách. Například Read přístup k C:\folder1\ znamená Read přístup k C:\folder1\file1.txt, C:\folder1\folder2\, C:\folder1\folder2\file2.txt atd.

Konstruktory

Vlastnosti

Metody

Platí pro

Viz také

• FileIOPermissionAccess
• FileIOPermissionAttribute