PermissionSetAttribute Klasse

Definition

Namespace:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Quelle:

PermissionSetAttribute.cs

Achtung

Code Access Security is not supported or honored by the runtime.

Lässt zu, dass Sicherheitsaktionen für PermissionSet mithilfe der deklarativen Sicherheit auf Code angewendet werden. Diese Klasse kann nicht vererbt werden.

C#

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
[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 PermissionSetAttribute : System.Security.Permissions.CodeAccessSecurityAttribute

Vererbung

Object

Attribute

SecurityAttribute

CodeAccessSecurityAttribute

PermissionSetAttribute

Attribute

AttributeUsageAttribute ObsoleteAttribute

Beispiele

Das folgende Beispiel zeigt die Verwendung der PermissionSetAttribute -Klasse.

C#

// The #define statement for BuildFile must be included the first time this sample is run.  
// This causes the sample to create a file named 'LocalIntranet.xml' in the c:\temp folder.  
// After creating the LocalInternet.xml file, comment out the #define statement and rerun 
// the sample to demonstrate the use of the permission set attribute.
#define BuildFile
using System;
using System.Security;
using System.Security.Permissions;
using System.Security.Policy;
using System.Collections;
using System.IO;

namespace PermissionSetAttributeDemo
{
    class Class1
    {		
        [STAThread]
        static void Main(string[] args)
        {
            // Run this sample with the BuildFile symbol defined to create the required file, then
            // comment out the #define statement to demonstrate the use of the attribute.
#if(BuildFile)
            using (StreamWriter sw = new StreamWriter("c:\\temp\\LocalIntranet.xml")) 
            {
                sw.WriteLine(GetNamedPermissionSet("LocalIntranet"));
                sw.Close();
            }
#endif
#if(!BuildFile)
            ReadFile1();
            ReadFile2();
            ReadFile3();
            Console.WriteLine("Press the Enter key to exit.");
            Console.Read();
#endif
        }
#if(!BuildFile)
        // Read the LocalIntranet.xml file.
        static void ReadFile1()
        {
            try
            {
                Console.WriteLine("Attempting to read a file using the FullTrust permission set.");
                using (StreamReader sr = new StreamReader("c:\\temp\\LocalIntranet.xml")) 
                {
                    string permissionSet = sr.ReadToEnd();
                    sr.Close();
                }
                Console.WriteLine("The file was successfully read.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
        [PermissionSetAttribute(SecurityAction.PermitOnly, File = "c:\\temp\\LocalIntranet.xml")]
            // Read the file with the specified security action on the file path.
        static void ReadFile2()
        {
            try
            {
                Console.WriteLine("Attempting to read a file using the LocalIntranet permission set.");
                using (StreamReader sr = new StreamReader("c:\\temp\\LocalIntranet.xml")) 
                {
                    string permissionSet = sr.ReadToEnd();
                    sr.Close();
                }
                Console.WriteLine("The file was successfully read.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
        [PermissionSetAttribute(SecurityAction.PermitOnly, Name = "LocalIntranet")]
            // Read the file with the specified security action on the permission set.
        static void ReadFile3()
        {
            try
            {
                Console.WriteLine("\nSecond attempt to read a file using " + 
                    "the LocalIntranet permission set.");
                using (StreamReader sr = new StreamReader("c:\\temp\\LocalIntranet.xml")) 
                {
                    string permissionSet = sr.ReadToEnd();
                    sr.Close();
                }
                Console.WriteLine("The file was successfully read.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
#endif
        // Locate the named permission set at the Machine level and return it as a string value.
        private static string GetNamedPermissionSet(string name)
        {
            IEnumerator policyEnumerator = SecurityManager.PolicyHierarchy();
            // Move through the policy levels to the Machine Level.
            while(policyEnumerator.MoveNext())
            {
                PolicyLevel currentLevel = (PolicyLevel)policyEnumerator.Current;
                if(currentLevel.Label == "Machine")
                {
                    // Iterate through the permission sets at the Machine level.
                    IList namedPermissions = currentLevel.NamedPermissionSets;
                    IEnumerator namedPermission = namedPermissions.GetEnumerator();
                    // Locate the named permission set.
                    while(namedPermission.MoveNext())
                    {
                        if(((NamedPermissionSet)namedPermission.Current).Name == name)
                        {
                            return ((NamedPermissionSet)namedPermission.Current).ToString();
                        }
                    }
                }
            }
            return null;
        }
    }
}
//
// This sample produces the following output:
//
// File created at c:\temp\LocalIntranet.xml
// Uncomment the BuildFile=false line and run the sample again.
//
// This sample completed successfully; press Exit to continue.
//
//
// The second time the sample is ran (without DEBUG flag):
//
// Attempting to read a file using the FullTrust permission set.
// The file was successfully read.
// Attempting to read a file using the LocalIntranet permission set.
// Request for the permission of type
// System.Security.Permissions.FileIOPermission, mscorlib, Version=1.0.5000.0,
// Culture=neutral, PublicKeyToken=b77a5c561934e089 failed.
//
// Second attempt to read a file using the LocalIntranet permission set.
// Request for the permission of type System.Security.Permissions.FileIOPermission,
// mscorlib, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
// failed.
// Press the Enter key to exit.

Hinweise

Achtung

Die Codezugriffssicherheit (CAS, Code Access Security) ist in allen Versionen von .NET Framework und .NET veraltet. Aktuelle Versionen von .NET berücksichtigen keine CAS-Anmerkungen und erzeugen Fehler, wenn CAS-bezogene APIs verwendet werden. Entwickler*innen sollten alternative Mittel zum Ausführen von Sicherheitsaufgaben suchen.

Die PermissionSetAttribute Eigenschaften Name, Fileund XML schließen sich gegenseitig aus, was bedeutet, dass ein Berechtigungssatz als Quelle nur eine der folgenden Quellen aufweisen kann: einen benannten Berechtigungssatz, eine Datei mit einer XML-Darstellung eines Berechtigungssatzes oder eine Zeichenfolge, die eine XML-Darstellung eines Berechtigungssatzes enthält.

Der zulässige Bereich der Deklaration hängt vom SecurityAction verwendeten ab. Ein SecurityAction für ein PermissionSet ausgeführtes ist das Äquivalent zum Ausführen dieser Aktion für jede der Berechtigungen innerhalb des Satzes.

Die von einem Sicherheitsattribute deklarierten Sicherheitsinformationen werden in den Metadaten des Attributziels gespeichert und vom System zur Laufzeit aufgerufen. Sicherheitsattribute werden nur für deklarative Sicherheit verwendet. Verwenden Sie für imperative Sicherheit die entsprechende Berechtigungsklasse.

Konstruktoren

PermissionSetAttribute(SecurityAction)

Veraltet. Initialisiert eine neue Instanz der PermissionSetAttribute-Klasse mit der angegebenen Sicherheitsaktion.

Eigenschaften

File	Veraltet. Ruft eine Datei ab, die die XML-Darstellung eines zu deklarierenden benutzerdefinierten Berechtigungssatzes enthält, oder legt diese fest.
Hex	Veraltet. Ruft die Hexadezimaldarstellung des XML-codierten Berechtigungssatzes ab oder legt diese fest.
Name	Veraltet. Ruft den Namen des Berechtigungssatzes ab oder legt diesen fest.
UnicodeEncoded	Veraltet. Ruft einen Wert ab, der angibt, ob die durch File angegebene Datei in Unicode oder ASCII codiert ist, oder legt diesen fest.
XML	Veraltet. Ruft die XML-Darstellung eines Berechtigungssatzes ab oder legt diese fest.

Methoden

CreatePermission()	Veraltet. Diese Methode wird nicht verwendet.
CreatePermissionSet()	Veraltet. Erstellt und gibt einen neuen Berechtigungssatz auf Grundlage dieses Berechtigungssatzattribut-Objekts zurück.

Gilt für:

Weitere Informationen

• PermissionSet
• NamedPermissionSet
• Erweitern von Metadaten mithilfe von Attributen