CodeConnectAccess Класс

Определение

Пространство имен:

System.Security.Policy

Сборка:

System.Security.Permissions.dll

Пакет:

System.Security.Permissions v9.0.0-preview.3.24172.9

Исходный код:

CodeConnectAccess.cs

Указывает доступ к ресурсам сети, который предоставляется коду.

public ref class CodeConnectAccess

public class CodeConnectAccess

type CodeConnectAccess = class

Public Class CodeConnectAccess

Наследование

Object

CodeConnectAccess

Примеры

В следующем примере кода создается NetCodeGroup объект и он добавляется на уровень политики пользователя.

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

Комментарии

Этот класс используется в сочетании с классом для NetCodeGroup управления тем, как выполняющийся код может подключаться к сайту, с который он был скачан. Эти классы обеспечивают программный контроль над предоставляемым WebPermission выполняющимся кодом, который определяет, какие схемы и порты код может использовать для доступа к исходному сайту. Можно указать разрешенные пары "схема" и "порт" на основе схемы в URL-адресе, по которому создается код.

Чтобы создать CodeConnectAccess объект на основе схемы источника кода, используйте CreateOriginSchemeAccess метод .

Чтобы создать CodeConnectAccess объект, который может использовать любую схему, но ограничен портом, используйте CreateAnySchemeAccess метод .

Конструкторы

CodeConnectAccess(String, Int32)

Инициализирует новый экземпляр класса CodeConnectAccess.

Поля

AnyScheme	Содержит строковое значение, представляющее шаблон схемы.
DefaultPort	Содержит значение, используемое для представления порта по умолчанию.
OriginPort	Содержит значение, используемое для представления значения порта в URI, где создан код.
OriginScheme	Содержит значение, используемое для представления схемы в URL, где создан код.

Свойства

Port	Получает порт, представленный текущим экземпляром.
Scheme	Получает схему URI, представленную текущим экземпляром.

Методы

CreateAnySchemeAccess(Int32)	Возвращает экземпляр CodeConnectAccess, представляющий доступ к заданному порту с использованием любой схемы.
CreateOriginSchemeAccess(Int32)	Возвращает экземпляр CodeConnectAccess, представляющий доступ к заданному порту, используя схему начала координат для кода.
Equals(Object)	Возвращает значение, указывающее, представляют ли два объекта CodeConnectAccess одинаковые схему и порт.
GetHashCode()	Выступает в качестве хэш-функции для определенного типа.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)