Export (0) Print
Expand All

CodeConnectAccess Class

Specifies the network resource access that is granted to code.

System.Object
  System.Security.Policy.CodeConnectAccess

Namespace:  System.Security.Policy
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class CodeConnectAccess

The CodeConnectAccess type exposes the following members.

  NameDescription
Public methodCodeConnectAccessInitializes a new instance of the CodeConnectAccess class.
Top

  NameDescription
Public propertyPortGets the port represented by the current instance.
Public propertySchemeGets the URI scheme represented by the current instance.
Top

  NameDescription
Public methodStatic memberCreateAnySchemeAccessReturns a CodeConnectAccess instance that represents access to the specified port using any scheme.
Public methodStatic memberCreateOriginSchemeAccessReturns a CodeConnectAccess instance that represents access to the specified port using the code's scheme of origin.
Public methodEqualsReturns a value indicating whether two CodeConnectAccess objects represent the same scheme and port. (Overrides Object.Equals(Object).)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Overrides Object.GetHashCode().)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public fieldStatic memberAnySchemeContains the string value that represents the scheme wildcard.
Public fieldStatic memberDefaultPortContains the value used to represent the default port.
Public fieldStatic memberOriginPortContains the value used to represent the port value in the URI where code originated.
Public fieldStatic memberOriginSchemeContains the value used to represent the scheme in the URL where the code originated.
Top

This class is used in conjunction with the NetCodeGroup class to control how executing code can connect back to the site it was downloaded from. These classes provide programmatic control of the WebPermission granted to executing code that controls what schemes and ports the code can use access its origin site. You can specify scheme and port pairs that are permitted based on the scheme in the URL where the code originates.

To create a CodeConnectAccess object based on the code's origin scheme, use the CreateOriginSchemeAccess method.

To create a CodeConnectAccess object that can use any scheme but is restricted by port, use the CreateAnySchemeAccess method.

The following code example creates a NetCodeGroup object and adds it to the User policy level.


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


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft