RegistryPermission.IsSubsetOf-Methode

Artikel
08/20/2007

Bestimmt, ob die aktuelle Berechtigung eine Teilmenge der angegebenen Berechtigung ist.

Namespace: System.Security.Permissions
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overrides Function IsSubsetOf ( _
    target As IPermission _
) As Boolean
'Usage
Dim instance As RegistryPermission
Dim target As IPermission
Dim returnValue As Boolean

returnValue = instance.IsSubsetOf(target)

public override bool IsSubsetOf (
    IPermission target
)

public:
virtual bool IsSubsetOf (
    IPermission^ target
) override

public boolean IsSubsetOf (
    IPermission target
)

public override function IsSubsetOf (
    target : IPermission
) : boolean

Parameter

target
Eine Berechtigung, für die geprüft werden soll, ob sie eine Teilmenge einer anderen Berechtigung ist. Diese Berechtigung muss von demselben Typ wie die aktuelle Berechtigung sein.

Rückgabewert

true, wenn die aktuelle Berechtigung eine Teilmenge der angegebenen Berechtigung ist, andernfalls false.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der target-Parameter ist nicht NULL (Nothing in Visual Basic) und nicht von demselben Typ wie die aktuelle Berechtigung.

Hinweise

Die aktuelle Berechtigung ist eine Teilmenge der angegebenen Berechtigung, wenn die aktuelle Berechtigung eine Gruppe von Operationen angibt, die vollständig in der angegebenen Berechtigung enthalten ist. Beispielsweise ist eine Berechtigung, die den Zugriff auf C:\beispiel.txt darstellt, eine Teilmenge einer Berechtigung, die den Zugriff auf C:\ darstellt. Wenn diese Methode true zurückgibt, stellt die aktuelle Berechtigung keine weitergehenden Zugriffsrechte für die geschützte Ressource dar als die angegebene Berechtigung.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der IsSubsetOf-Methode veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die RegistryPermission-Klasse.

' IsSubsetOf determines whether the current permission is a subset of the specified permission.
Private Function IsSubsetOfDemo() As Boolean

    Dim returnValue As Boolean = True

    If readPerm1.IsSubsetOf(readPerm2) Then

        Console.WriteLine(readPerm1.GetPathList(RegistryPermissionAccess.Read) + vbLf + " is a subset of " + readPerm2.GetPathList(RegistryPermissionAccess.Read) + vbLf)
    Else
        Console.WriteLine(readPerm1.GetPathList(RegistryPermissionAccess.Read) + vbLf + " is not a subset of " + readPerm2.GetPathList(RegistryPermissionAccess.Read) + vbLf)
    End If
    If createPerm1.IsSubsetOf(readPerm1) Then

        Console.WriteLine("RegistryPermissionAccess.Create" + vbLf + " is a subset of " + "RegistryPermissionAccess.Read" + vbLf)
    Else
        Console.WriteLine("RegistryPermissionAccess.Create" + vbLf + " is not a subset of " + "RegistryPermissionAccess.Read" + vbLf)
    End If

    Return returnValue

End Function 'IsSubsetOfDemo

// IsSubsetOf determines whether the current permission is a subset of the specified permission.
private bool IsSubsetOfDemo()
{

    bool returnValue = true;

    if (readPerm1.IsSubsetOf(readPerm2))
    {

        Console.WriteLine(readPerm1.GetPathList(RegistryPermissionAccess.Read) +
            "\n is a subset of " + readPerm2.GetPathList(RegistryPermissionAccess.Read) + "\n");
    }
    else
    {
        Console.WriteLine(readPerm1.GetPathList(RegistryPermissionAccess.Read) +
            "\n is not a subset of " + readPerm2.GetPathList(RegistryPermissionAccess.Read) + "\n");
    }
    if (createPerm1.IsSubsetOf(readPerm1))
    {

        Console.WriteLine("RegistryPermissionAccess.Create" +
            "\n is a subset of " + "RegistryPermissionAccess.Read" + "\n");
    }
    else
    {
        Console.WriteLine("RegistryPermissionAccess.Create" +
            "\n is not a subset of " + "RegistryPermissionAccess.Read" + "\n");
    }

    return returnValue;
}

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

RegistryPermission-Klasse
RegistryPermission-Member
System.Security.Permissions-Namespace

Freigeben über