FileIOPermissionAttribute-Klasse
Ermöglicht das Anwenden von Sicherheitsaktionen für FileIOPermission mithilfe der Deklarationssicherheit auf Code. Diese Klasse kann nicht geerbt werden.
Namespace: System.Security.Permissions
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Assembly Or AttributeTargets.Class Or AttributeTargets.Struct Or AttributeTargets.Constructor Or AttributeTargets.Method, AllowMultiple:=True, Inherited:=False)> _
Public NotInheritable Class FileIOPermissionAttribute
Inherits CodeAccessSecurityAttribute
'Usage
Dim instance As FileIOPermissionAttribute
[SerializableAttribute]
[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, AllowMultiple=true, Inherited=false)]
public sealed class FileIOPermissionAttribute : CodeAccessSecurityAttribute
[SerializableAttribute]
[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets::Assembly|AttributeTargets::Class|AttributeTargets::Struct|AttributeTargets::Constructor|AttributeTargets::Method, AllowMultiple=true, Inherited=false)]
public ref class FileIOPermissionAttribute sealed : public CodeAccessSecurityAttribute
/** @attribute SerializableAttribute() */
/** @attribute ComVisibleAttribute(true) */
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, AllowMultiple=true, Inherited=false) */
public final class FileIOPermissionAttribute extends CodeAccessSecurityAttribute
SerializableAttribute
ComVisibleAttribute(true)
AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, AllowMultiple=true, Inherited=false)
public final class FileIOPermissionAttribute extends CodeAccessSecurityAttribute
Hinweise
Dateien und Verzeichnisse werden mit absoluten Pfaden angegeben. Beim Zugriff auf Dateien wird eine Sicherheitsüberprüfung durchgeführt, wenn die Datei erstellt oder geöffnet wird. Die Sicherheitsprüfung wird erst wiederholt, wenn die Datei geschlossen und erneut geöffnet wird. Das Überprüfen von Berechtigungen beim ersten Zugriff auf eine Datei minimiert die Beeinträchtigung der Anwendungsleistung, da das Öffnen einer Datei ein einmaliger Vorgang ist, während Lese- und Schreibvorgänge in einer geöffneten Datei mehrmals erfolgen können.
Der zulässige Gültigkeitsbereich der Deklaration hängt von der verwendeten SecurityAction ab.
Die von einem Sicherheitsattribut deklarierten Sicherheitsinformationen werden in den Metadaten des Attributzieles gespeichert. Das System greift auf diese Sicherheitsinformationen zur Laufzeit zu. Sicherheitsattribute werden ausschließlich für deklarative Sicherheit verwendet. Verwenden Sie für imperative Sicherheit die entsprechende Berechtigungsklasse.
Warnung
Unrestricted FileIOPermission gewährt Zugriff auf alle Pfade in einem Dateisystem, einschließlich mehrerer Pfadnamen, über die auf dieselbe Datei zugegriffen wird. Um für den Zugriff auf eine Datei Deny festzulegen, müssen Sie Deny für alle möglichen Pfade der Datei festlegen. Wenn z. B. \\Server\Freigabe dem Netzlaufwerk X zugeordnet ist und Sie Deny für den Zugriff auf \\Server\Freigabe\Datei festlegen möchten, müssen Sie Deny für \\Server\Freigabe\Datei, X:\Datei und alle anderen Pfade festlegen, über die Sie auf die Datei zugreifen können.
Beispiel
Im folgenden Beispiel eines deklarativen Attributs wird eine ordnungsgemäße Anforderung einer FileIOPermission für den Vollzugriff auf die angegebene Datei dargestellt und erklärt, dass Sie zum Ausführen des Codes mindestens über diese Berechtigung verfügen müssen.
<Assembly: FileIOPermissionAttribute(SecurityAction.RequestMinimum, _
All := "C:\example\sample.txt")>
'In Visual Basic, you must specify that you are using the assembly scope when making a request.
[assembly:FileIOPermissionAttribute(SecurityAction.RequestMinimum, All="C:\\example\\sample.txt")]
//In C#, you must specify that you are using the assembly scope when making a request.
[assembly:FileIOPermissionAttribute(SecurityAction::RequestMinimum,All="C:\\example\\sample.txt")];
//In C++, you must specify that you are using the assembly scope when making a request.
/** @assembly FileIOPermissionAttribute(SecurityAction.RequestMinimum,
All = "C:\\example\\sample.txt")
*/
// In VJ#, you must specify that you are using the assembly scope
// when making a request.
Im folgenden Beispiel wird veranschaulicht, wie gefordert wird, dass der Aufrufcode zur Verknüpfungszeit über eine uneingeschränkte FileIOPermission verfügt. Anforderungen werden i. d. R. in verwalteten Bibliotheken (DLLs) vorgenommen, um Methoden und Klassen vor möglicherweise böswilligem Code zu schützen.
<FileIOPermissionAttribute(SecurityAction.Demand, _
Unrestricted := True)> Public Class SampleClass
[FileIOPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]
[FileIOPermissionAttribute(SecurityAction::Demand,Unrestricted=true)]
/** @attribute FileIOPermissionAttribute(SecurityAction.Demand,
Unrestricted = true)
*/
Vererbungshierarchie
System.Object
System.Attribute
System.Security.Permissions.SecurityAttribute
System.Security.Permissions.CodeAccessSecurityAttribute
System.Security.Permissions.FileIOPermissionAttribute
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
FileIOPermissionAttribute-Member
System.Security.Permissions-Namespace
FileIOPermission-Klasse
FileIOPermissionAccess-Enumeration