NetCodeGroup.AddConnectAccess(String, CodeConnectAccess) 方法

定义

将指定的连接访问权限添加到当前代码组。Adds the specified connection access to the current code group.

public:
 void AddConnectAccess(System::String ^ originScheme, System::Security::Policy::CodeConnectAccess ^ connectAccess);
public void AddConnectAccess (string originScheme, System.Security.Policy.CodeConnectAccess connectAccess);
member this.AddConnectAccess : string * System.Security.Policy.CodeConnectAccess -> unit
Public Sub AddConnectAccess (originScheme As String, connectAccess As CodeConnectAccess)

参数

originScheme
String

一个 String,包含要与代码的方案进行匹配的方案。A String containing the scheme to match against the code's scheme.

connectAccess
CodeConnectAccess

一个 CodeConnectAccess,指定代码可用来连接回其原始服务器的方案和端口。A CodeConnectAccess that specifies the scheme and port code can use to connect back to its origin server.

例外

originSchemenulloriginScheme is null.

originScheme 包含方案中不允许的字符。originScheme contains characters that are not permitted in schemes.

- 或 --or- originScheme = AbsentOriginSchemeconnectAccess 指定 OriginScheme 作为其方案。originScheme = AbsentOriginScheme and connectAccess specifies OriginScheme as its scheme.

示例

下面的代码示例演示如何创建对象并将其添加 CodeConnectAccessNetCodeGroup 中。The following code example demonstrates creating and adding CodeConnectAccess objects to a 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();
}

注解

可以为同一添加多个 CodeConnectAccess 对象 origin schemeYou can add multiple CodeConnectAccess objects for the same origin scheme. 如果 origin scheme 已有一个或多个关联 CodeConnectAccess 的对象,则为指定将 null connectAccess 不起作用。If an origin scheme already has one or more associated CodeConnectAccess objects, specifying null for connectAccess has no effect. 如果源方案没有关联的 CodeConnectAccess 对象,则为指定 nullconnectAccess 防止代码的原始方案与 originScheme 访问其源服务器的匹配。If the origin scheme does not have associated CodeConnectAccess objects, specifying null for connectAccess prevents code with an origin scheme that matches originScheme from accessing its origin server.

适用于