NetCodeGroup Sınıf

Tanım

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

public sealed class NetCodeGroup : 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

type NetCodeGroup = class
    inherit 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

Devralma

Object

CodeGroup

NetCodeGroup

Öznitelikler

SerializableAttribute ComVisibleAttribute

Örnekler

Aşağıdaki kod örneği, HTTP şeması kullanılarak indirilen kod için nesne NetCodeGroup oluşturmayı ve nesneleri eklemeyi CodeConnectAccess gösterir.

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

Açıklamalar

Kod grupları, kod erişimi güvenlik ilkesinin yapı taşlarıdır. Her ilke düzeyi, bir veya daha fazla alt kod grubuna sahip olabilecek bir kök kod grubundan oluşur. Her alt kod grubunun kendi alt kod grupları olabilir; bu davranış herhangi bir sayıda düzeye genişleterek bir ağaç oluşturur. Her kod grubunun, o derlemenin kanıtına bağlı olarak belirli bir derlemenin gruba ait olup olmadığını belirleyen bir üyelik koşulu vardır. Yalnızca üyelik koşulları belirli bir derlemeyle eşleşen kod grupları, alt kod gruplarıyla birlikte kod erişimi güvenlik ilkesi uygular.

NetCodeGroup ile aynı birleştirme semantiğine UnionCodeGroupsahiptir; eşleşen tüm alt kod gruplarının nesnelerinin PolicyStatement birleşimini oluşturur ve PolicyStatement giriş Url kanıtından üretir. Ancak, NetCodeGroup kodun çalıştırıldığı siteye bağlanma erişimi veren dinamik olarak hesaplanan WebPermission bir izin döndürür; UnionCodeGroup yalnızca statik bir izin kümesi döndürür.

NetCodeGroup oluşturulduğunda, aşağıdaki tabloda gösterilen varsayılan bağlantı erişim kurallarını içerir.

Uygun ve özellik değerlerine AddConnectAccess sahip Scheme bir CodeConnectAccess nesneyi yöntemine geçirerek, kodun kaynak sitesine geri bağlanırken kullanmasına izin verilen düzeni ve Port bağlantı noktasını denetleyebilirsiniz. Kaynak şeması kanıtta bulunmadığında veya düzen olarak ("") belirterek AbsentOriginScheme tanınmadığında geçerli olan bir bağlantı erişim kuralı oluşturabilirsiniz. Ayrıca, düzen olarak ("*") belirterek AnyOtherOriginScheme eşleşen bir düzen ile bağlantı erişim kuralı olmadığında geçerli olan bir bağlantı erişim kuralı da oluşturabilirsiniz.

Oluşturucular

Alanlar

Özellikler

Yöntemler

Şunlara uygulanır