StrongNameIdentityPermission.Union(IPermission) Método

Definição

Namespace:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Cria uma permissão que é a união entre a permissão atual e a permissão especificada.

public:
 override System::Security::IPermission ^ Union(System::Security::IPermission ^ target);

public override System.Security.IPermission Union (System.Security.IPermission target);

override this.Union : System.Security.IPermission -> System.Security.IPermission

Public Overrides Function Union (target As IPermission) As IPermission

Parâmetros

target

IPermission

Uma permissão a ser combinada com a permissão atual. Ele deve ser do mesmo tipo da permissão atual.

Retornos

IPermission

Uma nova permissão que representa a união da permissão atual e da permissão especificada.

Exceções

ArgumentException

O parâmetro target não é null e não é do mesmo tipo que a permissão atual.

- ou -

As duas permissões não são iguais e uma é um subconjunto da outra.

Exemplos

O exemplo de código a seguir mostra os resultados do uso do Union método, não como usar o método . Este exemplo faz parte de um exemplo maior fornecido para a StrongNameIdentityPermission classe . O melhor uso para este exemplo é criar e executar todo o exemplo e exibir sua saída.

Observação

O exemplo de código destina-se a mostrar o comportamento do método, não para demonstrar seu uso. Em geral, os métodos de classes de permissão são usados pela infraestrutura de segurança; normalmente, eles não são usados em aplicativos.

// Union creates a new permission that is the union of the current permission and the specified permission.
bool UnionDemo()
{
    bool returnValue = true;
    StrongNameIdentityPermission^ snIdPerm1;
    StrongNameIdentityPermission^ snIdPerm2;
    IPermission^ snIdPerm3;
    snIdPerm1 = gcnew StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.*", gcnew Version("1.0.0.0"));
    snIdPerm2 = gcnew StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.MyFile", gcnew Version("1.0.0.0"));
    snIdPerm3 = dynamic_cast<StrongNameIdentityPermission^>(snIdPerm1->Union( snIdPerm2 ));
    snIdPerm3 = snIdPerm1->Union( snIdPerm2 );

    try
    {
        Console::WriteLine("The union of MyCompany.MyDepartment.*" +
            "and MyCompany.MyDepartment.MyFile is " +
            (dynamic_cast<StrongNameIdentityPermission^>(snIdPerm3))->Name); 
    }
    catch (Exception^ e)
    {
        Console::WriteLine("An expected exception was thrown: " + e->Message);
    }


    return returnValue;
}

// Union creates a new permission that is the union of the current permission and the specified permission.
private bool UnionDemo()
{

    bool returnValue = true;

    StrongNameIdentityPermission snIdPerm1, snIdPerm2;
    IPermission snIdPerm3;

    snIdPerm1 = new StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.*", new Version("1.0.0.0"));
    snIdPerm2 = new StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.MyFile", new Version("1.0.0.0"));

    snIdPerm3 = (StrongNameIdentityPermission)snIdPerm1.Union(snIdPerm2);

    try
    {
        Console.WriteLine("The union of MyCompany.MyDepartment.*" +
        "and MyCompany.MyDepartment.MyFile is " +
        ((StrongNameIdentityPermission)snIdPerm3).Name.ToString());
    }
    catch (Exception e)
    {
        Console.WriteLine("An expected exception was thrown: " + e.Message);
    }

    return returnValue;
}

' Union creates a new permission that is the union of the current permission and the specified permission.
Private Function UnionDemo() As Boolean 
    
    Dim returnValue As Boolean = True
    
    Dim snIdPerm1, snIdPerm2 As StrongNameIdentityPermission
    Dim snIdPerm3 As IPermission
    
    snIdPerm1 = New StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.*", New Version("1.0.0.0"))
    snIdPerm2 = New StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.MyFile", New Version("1.0.0.0"))
    
    snIdPerm3 = CType(snIdPerm1.Union(snIdPerm2), StrongNameIdentityPermission)
    
    Try
        Console.WriteLine("The union of MyCompany.MyDepartment.*" + "and MyCompany.MyDepartment.MyFile is " + CType(snIdPerm3, StrongNameIdentityPermission).Name.ToString())
    Catch e As Exception
        Console.WriteLine("An expected exception was thrown: " + e.Message)
    End Try
    
    
    Return returnValue

End Function 'UnionDemo

Comentários

O resultado de uma chamada para Union é uma permissão que representa todas as operações representadas pela permissão atual e pela permissão especificada. Qualquer exigência que passe qualquer permissão passa pelo sindicato.

A união de uma permissão e null é a permissão que não nullé . A união de uma permissão e um subconjunto dessa permissão é a permissão que contém a outra. Qualquer outra combinação resulta na geração de uma exceção ArgumentException .