NetCodeGroup.AddConnectAccess(String, CodeConnectAccess) Yöntem

Tanım

Ad Alanı:

System.Security.Policy

Bütünleştirilmiş Kod:

System.Security.Permissions.dll

Paket:

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

Kaynak:

NetCodeGroup.cs

Belirtilen bağlantı erişimini geçerli kod grubuna ekler.

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)

Parametreler

originScheme

String

String Kodun düzeniyle eşleşecek düzeni içeren.

connectAccess

CodeConnectAccess

CodeConnectAccess Şemayı ve bağlantı noktası kodunun kaynak sunucusuna geri bağlanmak için kullanabileceğini belirten bir.

Özel durumlar

ArgumentNullException

originScheme, null değeridir.

ArgumentOutOfRangeException

originScheme düzenlerde izin verilmeyen karakterler içerir.

-veya-

originScheme = AbsentOriginScheme ve connectAccess şeması olarak belirtir OriginScheme .

Örnekler

Aşağıdaki kod örneğinde bir nesnesi NetCodeGroupoluşturma ve ekleme CodeConnectAccess işlemleri gösterilmektedir.

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

Aynı origin schemeiçin birden çok CodeConnectAccess nesne ekleyebilirsiniz. Bir zaten bir origin scheme veya daha fazla ilişkili CodeConnectAccess nesne varsa, öğesini connectAccess belirtmenin null hiçbir etkisi yoktur. Kaynak düzeni ilişkili CodeConnectAccess nesnelere sahip değilse, öğesinin connectAccess belirtilmesinull, kaynak şemasıyla eşleşen originScheme kodun kaynak sunucusuna erişmesini engeller.