FileDialogPermission.Union-Methode

Erstellt eine Berechtigung als Gesamtmenge der aktuellen und der angegebenen Berechtigung.

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

Syntax

'Declaration
Public Overrides Function Union ( _
    target As IPermission _
) As IPermission
'Usage
Dim instance As FileDialogPermission
Dim target As IPermission
Dim returnValue As IPermission

returnValue = instance.Union(target)

public override IPermission Union (
    IPermission target
)

public:
virtual IPermission^ Union (
    IPermission^ target
) override

public IPermission Union (
    IPermission target
)

public override function Union (
    target : IPermission
) : IPermission

Parameter

• target
  Eine Berechtigung, die mit der aktuellen Berechtigung kombiniert werden soll. Diese muss von demselben Typ wie die aktuelle Berechtigung sein.

Rückgabewert

Eine neue Berechtigung, die die Gesamtmenge der aktuellen und der angegebenen Berechtigung darstellt.

Ausnahmen

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

Hinweise

Das Ergebnis eines Aufrufs von Union ist eine Berechtigung, die alle Vorgänge darstellt, die sowohl durch die aktuelle Berechtigung als auch durch die angegebene Berechtigung dargestellt werden. Anforderungen, die eine der beiden Berechtigungen erfolgreich durchlaufen, durchlaufen auch deren Gesamtmenge erfolgreich.

Beispiel

Im folgenden Codebeispiel soll lediglich das Verhalten der Union-Methode veranschaulicht werden, nicht ihre Verwendung. Im Allgemeinen werden die Methoden von Berechtigungsklassen durch die Sicherheitsinfrastruktur verwendet; sie sind nicht für die Verwendung in Anwendungen bestimmt. Im folgenden Codebeispiel wird jedoch veranschaulicht, wie sich die Methode verhält, wenn sie aus Ihrem Code ausgeführt wird. Den vollständigen Beispielcode finden Sie unter der FileDialogPermission-Klasse.

Private Function UnionDemo() As Boolean 
    Dim returnValue As Boolean = True
    
    fileDialogPerm3 = CType(fileDialogPerm1.Union(fileDialogPerm2), FileDialogPermission)
    
    If fileDialogPerm3 Is Nothing Then
        Console.WriteLine("The union of " + fileDialogPerm1.Access.ToString() + _
        " and " + fileDialogPerm2.Access.ToString() + " is null.")
    Else
        Console.WriteLine("The union of " + fileDialogPerm1.Access.ToString() + _
        " and " + fileDialogPerm2.Access.ToString() + " = " + _
        CType(fileDialogPerm3, FileDialogPermission).Access.ToString())
    End If
    
    Return returnValue

End Function 'UnionDemo
 

private bool UnionDemo()
{
    bool returnValue = true;

            fileDialogPerm3 = (FileDialogPermission)fileDialogPerm1.Union(fileDialogPerm2);

            if (fileDialogPerm3 == null)
            {
                Console.WriteLine("The union of " + fileDialogPerm1.Access + 
                    " and " + fileDialogPerm2.Access + " is null.");
            }
            else
            {
                Console.WriteLine("The union of " + fileDialogPerm1.Access + " and " +
                    fileDialogPerm2.Access + " = " +
                    ((FileDialogPermission)fileDialogPerm3).Access.ToString());
            }

    return returnValue;

}

bool UnionDemo()
{
    bool returnValue = true;
    FileDialogPermission^ fileDialogIdPerm1 = gcnew FileDialogPermission(FileDialogPermissionAccess::Open );
    FileDialogPermission^ fileDialogIdPerm2 = gcnew FileDialogPermission( FileDialogPermissionAccess::OpenSave );
    FileDialogPermission^ fileDialogIdPerm3 = gcnew FileDialogPermission(PermissionState::None);
    fileDialogIdPerm3 = dynamic_cast<FileDialogPermission^>(fileDialogIdPerm1->Union( fileDialogIdPerm2 ));
    if ( fileDialogIdPerm3 == nullptr )
    {
        Console::WriteLine( "The union of {0} and {1} is null.", 
            fileDialogIdPerm1->Access, fileDialogIdPerm2->Access );
    }
    else
    {
        Console::WriteLine( "The union of {0} and {1} = {2}", 
            fileDialogIdPerm1->Access, fileDialogIdPerm2->Access, (dynamic_cast<FileDialogPermission^>(fileDialogIdPerm3))->Access );
    }
    return returnValue;
}

// Union creates a new permission that is the union of 
// the current permission and the
// specified permission.
private boolean UnionDemo() 
{
    boolean returnValue = true;
    FileDialogPermissionAccess fileDialog1[] = 
        new FileDialogPermissionAccess[1];
    FileDialogPermissionAccess fileDialog2[] = 
        new FileDialogPermissionAccess[1];
    FileDialogPermission fileDialogIdPerm1[] = 
        new FileDialogPermission[1];
    FileDialogPermission fileDialogIdPerm2[] = 
        new FileDialogPermission[1];
    IPermission fileDialogIdPerm3;
    FileDialogGenerator fileDialogGen1 =  
        new FileDialogGenerator();
    FileDialogGenerator fileDialogGen2 =  
        new FileDialogGenerator();
    fileDialogGen1.ResetIndex();
    while(fileDialogGen1.CreateFileDialog(fileDialogIdPerm1, 
        fileDialog1)) {
        if (fileDialogIdPerm1[0] == null) {
            continue ;
        }
        Console.WriteLine("************************" 
            + "**********************************\n");
        fileDialogGen2.ResetIndex();
        
        while(fileDialogGen2.CreateFileDialog(fileDialogIdPerm2, 
            fileDialog2)) {
            if (fileDialogIdPerm2[0] == null) {
                continue ;
            }
            fileDialogIdPerm3 =((FileDialogPermission)(
                fileDialogIdPerm1[0].Union(fileDialogIdPerm2[0])));
            fileDialogIdPerm3 = fileDialogIdPerm1[0].
                Union(fileDialogIdPerm2[0]);
            
            if (fileDialogIdPerm3 == null) {
                Console.WriteLine(("The union of " + fileDialog1[0] 
                    + " and " + fileDialog2[0] + " is null."));
            }
            else {
                Console.WriteLine(("The union of " 
                    + fileDialogIdPerm1[0].get_Access() + " and " 
                    + fileDialogIdPerm2[0].get_Access() + " = " 
                    + ((FileDialogPermission)(fileDialogIdPerm3)).
                    get_Access().ToString()));
            }
        }
    }
    return returnValue ;
} //UnionDemo

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

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