EnvironmentPermission.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 EnvironmentPermission
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 einen Zustand beschreibt, der 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 EnvironmentPermission-Klasse.

Private Function IsSubsetOfDemo() As Boolean 
    Dim returnValue As Boolean = True
    Dim envPerm1 As New EnvironmentPermission(EnvironmentPermissionAccess.Read, "windir")
    Dim envPerm2 As New EnvironmentPermission(EnvironmentPermissionAccess.AllAccess, "TEMP")
    If envPerm1.IsSubsetOf(envPerm2) Then
        
        Console.WriteLine("'windir' is a subset of 'TEMP'" + vbLf)
    Else
        Console.WriteLine("windir" + " is not a subset of " + "TEMP" + vbLf)
    End If
    envPerm1.SetPathList(EnvironmentPermissionAccess.Read, "TEMP")
    
    If envPerm1.IsSubsetOf(envPerm2) Then
        
        Console.WriteLine("Read access is a subset of AllAccess" + vbLf)
    Else
        Console.WriteLine("Read access is not a subset of AllAccess" + vbLf)
    End If
    
    Return returnValue

End Function 'IsSubsetOfDemo

private bool IsSubsetOfDemo()
{
    bool returnValue = true;
    EnvironmentPermission envPerm1 = new EnvironmentPermission(EnvironmentPermissionAccess.Read, "windir");
    EnvironmentPermission envPerm2 = new EnvironmentPermission(EnvironmentPermissionAccess.AllAccess, "TEMP");
    if (envPerm1.IsSubsetOf(envPerm2))
    {

        Console.WriteLine("'windir' is a subset of 'TEMP'\n");
    }
    else
    {
        Console.WriteLine("windir" + " is not a subset of "
            + "TEMP" + "\n");
    }
    envPerm1.SetPathList(EnvironmentPermissionAccess.Read, "TEMP");

    if (envPerm1.IsSubsetOf(envPerm2))
    {

        Console.WriteLine("Read access is a subset of AllAccess\n");
    }
    else
    {
        Console.WriteLine("Read access is not a subset of AllAccess\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

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

Freigeben über