NetCodeGroup Classe

Definição

public ref class NetCodeGroup sealed : System::Security::Policy::CodeGroup

[System.Serializable]
public sealed class NetCodeGroup : System.Security.Policy.CodeGroup

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class NetCodeGroup : System.Security.Policy.CodeGroup

[<System.Serializable>]
type NetCodeGroup = class
    inherit CodeGroup

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type NetCodeGroup = class
    inherit CodeGroup

Public NotInheritable Class NetCodeGroup
Inherits CodeGroup

Herança

Object

CodeGroup

NetCodeGroup

Atributos

SerializableAttribute ComVisibleAttribute

Exemplos

O exemplo de código seguinte demonstra a criação de um NetCodeGroup e a adição CodeConnectAccess de objetos para código descarregado usando o esquema HTTP.

static void SetNetCodeGroupAccess()
{
    String^ userPolicyLevel = "User";
    // Locate the User policy level.
    PolicyLevel^ level = nullptr;
    System::Collections::IEnumerator^ ph = 
        System::Security::SecurityManager::PolicyHierarchy();
    while(ph->MoveNext())
    {
        level = (PolicyLevel^)ph->Current;
        if (level->Label == userPolicyLevel)
        {
            break;       
        }
    }
    if (level->Label != userPolicyLevel)
        throw gcnew ApplicationException("Could not find User policy level.");

    IMembershipCondition^ membership =
        gcnew UrlMembershipCondition("http://www.contoso.com/*");
    NetCodeGroup^ codeGroup = gcnew NetCodeGroup(membership);
    // Delete default settings.
    codeGroup->ResetConnectAccess();
    // Create an object that represents access to the FTP scheme and 
    // default port.
    CodeConnectAccess^ CodeAccessFtp = 
        gcnew CodeConnectAccess(Uri::UriSchemeFtp, 
        CodeConnectAccess::DefaultPort);
    // Create an object that represents access to the HTTPS scheme 
    // and default port.
    CodeConnectAccess^ CodeAccessHttps = 
        gcnew CodeConnectAccess(Uri::UriSchemeHttps, 
        CodeConnectAccess::DefaultPort);
    // Create an object that represents access to the origin 
    // scheme and port.
    CodeConnectAccess^ CodeAccessOrigin = 
        CodeConnectAccess::CreateOriginSchemeAccess
        (CodeConnectAccess::OriginPort);
    // Add connection access objects to the NetCodeGroup object.
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessFtp);
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessHttps);
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessOrigin);
    // Provide name and description information for caspol.exe tool.
    codeGroup->Name = "ContosoHttpCodeGroup";
    codeGroup->Description = "Code originating from contoso.com can" +
        " connect back using the FTP or HTTPS.";
    // Add the code group to the User policy's root node.
    level->RootCodeGroup->AddChild(codeGroup);
    // Save the changes to the policy level.
    System::Security::SecurityManager::SavePolicy();
}

public static void SetNetCodeGroupAccess()
{
    const string userPolicyLevel = "User";
    // Locate the User policy level.
    PolicyLevel level = null;
    System.Collections.IEnumerator ph =
        System.Security.SecurityManager.PolicyHierarchy();
    while(ph.MoveNext())
    {
        level = (PolicyLevel)ph.Current;
        if( level.Label == userPolicyLevel )
        {
            break;
        }
    }
    if (level.Label != userPolicyLevel)
        throw new ApplicationException("Could not find User policy level.");

    IMembershipCondition membership =
        new UrlMembershipCondition(@"http://www.contoso.com/*");
    NetCodeGroup codeGroup = new NetCodeGroup(membership);
    // Delete default settings.
    codeGroup.ResetConnectAccess();
    // Create an object that represents access to the FTP scheme and default port.
    CodeConnectAccess a1 = new CodeConnectAccess(Uri.UriSchemeFtp, CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the HTTPS scheme and default port.
    CodeConnectAccess a2 = new CodeConnectAccess(Uri.UriSchemeHttps, CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the origin scheme and port.
    CodeConnectAccess a3 = CodeConnectAccess.CreateOriginSchemeAccess(CodeConnectAccess.OriginPort);
    // Add connection access objects to the NetCodeGroup object.
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a1);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a2);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a3);
    // Provide name and description information for caspol.exe tool.
    codeGroup.Name = "ContosoHttpCodeGroup";
    codeGroup.Description = "Code originating from contoso.com can connect back using the FTP or HTTPS.";
    // Add the code group to the User policy's root node.
    level.RootCodeGroup.AddChild(codeGroup);
    // Save the changes to the policy level.
    System.Security.SecurityManager.SavePolicy();
}

Observações

Os grupos de código são os blocos de construção da política de segurança de acesso ao código. Cada nível de política consiste num grupo de código raiz que pode ter um ou mais grupos de código filhos. Cada grupo de código filho pode ter os seus próprios grupos de códigos-filhos; Este comportamento estende-se a qualquer número de níveis, formando uma árvore. Cada grupo de código tem uma condição de pertença que determina se uma dada assembleia pertence ao grupo, com base na evidência dessa assembleia. Apenas grupos de código cujas condições de pertença correspondem a uma dada assembleia, juntamente com os seus grupos de código filhos, aplicam a política de segurança de acesso ao código.

NetCodeGroup tem a mesma semântica de fusão que a de UnionCodeGroup; forma a união dos PolicyStatement objetos de todos os grupos de códigos filhos correspondentes e gera PolicyStatement a partir da evidência de entrada Url . No entanto, NetCodeGroup devolve uma permissão contendo um cálculo WebPermission dinâmico que concede acesso de ligação ao site a partir do qual o código é executado; UnionCodeGroup simplesmente devolve um conjunto de permissões estático.

Quando um é criado NetCodeGroup , contém as regras de acesso à ligação padrão apresentadas na tabela seguinte.

Pode controlar o esquema e a porta que o código pode usar ao voltar a ligar ao local de origem, passando um CodeConnectAccess objeto com os valores e Port propriedades apropriados Scheme ao AddConnectAccess método. Pode criar uma regra de acesso à ligação que se aplique quando o esquema de origem não está presente na evidência ou não é reconhecido, especificando AbsentOriginScheme ("") como o esquema. Também pode criar uma regra de acesso à ligação que se aplique quando não existe uma regra de acesso à ligação com um esquema correspondente, especificando AnyOtherOriginScheme ("*") como o esquema.