CodeConnectAccess 類別

定義

命名空間:

System.Security.Policy

組件:

System.Security.Permissions.dll

組件:

mscorlib.dll

指定要授與程式碼的網路資源存取權限。

public ref class CodeConnectAccess

public class CodeConnectAccess

[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class CodeConnectAccess

type CodeConnectAccess = class

[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type CodeConnectAccess = class

Public Class CodeConnectAccess

繼承

Object

CodeConnectAccess

屬性

ComVisibleAttribute SerializableAttribute

範例

下列程式碼範例會 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 (程式碼來源的 URL) 中配置的值。

屬性

Port	取得目前執行個體所表示的連接埠。
Scheme	取得目前執行個體所表示的 URI 配置。

方法

CreateAnySchemeAccess(Int32)	傳回 CodeConnectAccess 執行個體，表示使用任何配置來存取指定的連接埠。
CreateOriginSchemeAccess(Int32)	傳回 CodeConnectAccess 執行個體，表示使用程式碼的原始配置來存取指定的連接埠。
Equals(Object)	傳回數值，指出兩個 CodeConnectAccess 物件是否代表相同的配置和連接埠。
GetHashCode()	以特定類型的雜湊函式進行服務。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)