FileIOPermission Klasse

Definition

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

Vererbung

Object

CodeAccessPermission

FileIOPermission

Attribute

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implementiert

IUnrestrictedPermission

Beispiele

Die folgenden Beispiele veranschaulichen Code, der verwendet FileIOPermission. Nach den folgenden zwei Codezeilen stellt das -Objekt f die Berechtigung zum Lesen aller Dateien auf den lokalen Datenträgern des Clientcomputers dar. Im Codebeispiel wird dann die Berechtigung angefordert, um zu bestimmen, ob die Anwendung über die Berechtigung zum Lesen der Dateien verfügt.

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

Nach den folgenden zwei Codezeilen stellt das -Objekt f2 Berechtigungen zum Lesen von C:\test_r sowie zum Lesen und Schreiben in C:\example\out.txt dar. Read und Write stellen die Datei-/Ordnerberechtigungen wie zuvor beschrieben dar. Nach dem Erstellen der Berechtigung fordert der Code die Berechtigung an, um zu bestimmen, ob die Anwendung das Recht hat, die Datei zu lesen und in die Datei zu schreiben.

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

Hinweise

Diese Berechtigung unterscheidet zwischen den folgenden vier Arten von Datei-E/A-Zugriff, die von bereitgestellt werden FileIOPermissionAccess:

• Read: Lesezugriff auf den Inhalt der Datei oder Zugriff auf Informationen zur Datei, z. B. länge oder Zeitpunkt der letzten Änderung.

• Write: Schreibzugriff auf den Inhalt der Datei oder Zugriff, um Informationen zur Datei zu ändern, z. B. ihren Namen. Ermöglicht auch das Löschen und Überschreiben.

• Append: Die Möglichkeit, nur an das Ende einer Datei zu schreiben. Keine Lesemöglichkeit.

• PathDiscovery: Zugriff auf die Informationen im Pfad selbst. Dies trägt zum Schutz vertraulicher Informationen im Pfad bei, z. B. Benutzernamen, sowie Informationen zur Verzeichnisstruktur, die im Pfad angezeigt wird. Dieser Wert gewährt keinen Zugriff auf Dateien oder Ordner, die durch den Pfad dargestellt werden.

Alle diese Berechtigungen sind unabhängig, was bedeutet, dass Rechte für eine andere nicht bedeuten. Beispielsweise Write impliziert die Berechtigung nicht die Berechtigung für Read oder Append. Wenn mehr als eine Berechtigung gewünscht ist, können sie mithilfe eines bitweisen OR kombiniert werden, wie im folgenden Codebeispiel gezeigt. Die Dateiberechtigung ist als kanonische absolute Pfade definiert. Aufrufe sollten immer mit kanonischen Dateipfaden erfolgen.

FileIOPermission beschreibt geschützte Vorgänge für Dateien und Ordner. Die File -Klasse bietet sicheren Zugriff auf Dateien und Ordner. Die Sicherheitszugriffsprüfung wird ausgeführt, wenn das Handle für die Datei erstellt wird. Durch die Überprüfung bei der Erstellung werden die Auswirkungen der Sicherheitsüberprüfung auf die Leistung minimiert. Das Öffnen einer Datei erfolgt einmal, während Lese- und Schreibvorgänge mehrmals erfolgen können. Nachdem die Datei geöffnet wurde, werden keine weiteren Überprüfungen durchgeführt. Wenn das Objekt an einen nicht vertrauenswürdigen Aufrufer übergeben wird, kann es missbraucht werden. Beispielsweise sollten Dateihandles nicht in öffentlichen globalen Statischen gespeichert werden, in denen Code mit weniger Berechtigungen darauf zugreifen kann.

FileIOPermissionAccess gibt Aktionen an, die für die Datei oder den Ordner ausgeführt werden können. Darüber hinaus können diese Aktionen mithilfe eines bitweisen OR kombiniert werden, um komplexe Instanzen zu bilden.

Der Zugriff auf einen Ordner impliziert den Zugriff auf alle darin enthaltenen Dateien sowie den Zugriff auf alle Dateien und Ordner in seinen Unterordnern. Der Zugriff auf C:\ordner1\ impliziert Read beispielsweise Read Zugriff auf C:\folder1\file1.txt, C:\Ordner1\Ordner2\, C:\folder1\folder2\file2.txt usw.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• FileIOPermissionAccess
• FileIOPermissionAttribute