CodeConnectAccess Classe

Definição

Namespace:

System.Security.Policy

Assembly:

System.Security.Permissions.dll

Origem:

CodeConnectAccess.cs

Especifica o acesso de recurso de rede que é concedido ao código.

public ref class CodeConnectAccess

public class CodeConnectAccess

type CodeConnectAccess = class

Public Class CodeConnectAccess

Herança

Object

CodeConnectAccess

Exemplos

O exemplo de código a seguir cria um NetCodeGroup objeto e o adiciona ao nível de política de usuário.

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();
}

Comentários

Essa classe é usada em conjunto com a NetCodeGroup classe para controlar como o código em execução pode se conectar de volta ao site do qual ele foi baixado. Essas classes fornecem controle programático do WebPermission concedido à execução de código que controla quais esquemas e portas o código pode usar para acessar seu site de origem. Você pode especificar pares de esquema e porta permitidos com base no esquema na URL de origem do código.

Para criar um CodeConnectAccess objeto com base no esquema de origem do código, use o CreateOriginSchemeAccess método .

Para criar um CodeConnectAccess objeto que pode usar qualquer esquema, mas é restrito por porta, use o CreateAnySchemeAccess método .

Construtores

CodeConnectAccess(String, Int32)

Inicializa uma nova instância da classe CodeConnectAccess.

Campos

AnyScheme	Contém o valor de cadeia de caracteres que representa o caractere curinga de esquema.
DefaultPort	Contém o valor usado para representar a porta padrão.
OriginPort	Contém o valor usado para representar o valor da porta no URI em que o código é originado.
OriginScheme	Contém o valor usado para representar o esquema na URL em que o código é originado.

Propriedades

Port	Obtém a porta representada pela instância atual.
Scheme	Obtém o esquema do URI representado pela instância atual.

Métodos

CreateAnySchemeAccess(Int32)	Retorna uma instância CodeConnectAccess que representa o acesso à porta especificada usando qualquer esquema.
CreateOriginSchemeAccess(Int32)	Retorna uma instância CodeConnectAccess que representa o acesso à porta especificada usando o esquema de origem do código.
Equals(Object)	Retorna um valor que indica se dois objetos CodeConnectAccess representam o mesmo esquema e porta.
GetHashCode()	Serve como uma função hash para um tipo particular.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)