NetCodeGroup, classe

Les groupes de codes sont les blocs de construction d'une stratégie de sécurité d'accès du code. Chaque niveau de stratégie est constitué d'un groupe de codes racine qui peut avoir un ou plusieurs groupes de codes enfants. Chaque groupe de codes enfant peut avoir ses propres groupes de code enfants ; ce comportement peut s'étendre jusqu'à n'importe quel nombre de niveaux, formant une arborescence. Chaque groupe de codes possède une condition d'appartenance qui détermine si un assembly donné appartient au groupe en fonction de la preuve de cet assembly. Seuls les groupes de codes dont les conditions d'appartenance correspondent à un assembly donné et à leurs groupes de codes enfants appliquent une stratégie de sécurité d'accès du code.

NetCodeGroup a la même sémantique de fusion que celle de UnionCodeGroup ; il forme l'union des objets PolicyStatement de tous les groupes de codes enfants correspondants et le PolicyStatement qu'il génère à partir de la preuve de Url d'entrée. Toutefois, NetCodeGroup retourne une autorisation contenant un WebPermission calculé dynamiquement qui accorde un accès de connexion au site à partir duquel le code est exécuté ; UnionCodeGroup retourne simplement un jeu d'autorisations statique.

Lorsqu'un NetCodeGroup est créé, il contient les règles d'accès de connexion par défaut affichées dans le tableau suivant.

Vous pouvez contrôler le modèle et le port que le code est autorisé à utiliser lors de la connexion à son site d'origine en passant un objet CodeConnectAccess avec les valeurs des propriétés Scheme et Port appropriées à la méthode AddConnectAccess. Vous pouvez créer une règle d'accès de connexion qui s'applique lorsque le modèle d'origine n'est pas présent dans la preuve ou n'est pas reconnu en spécifiant AbsentOriginScheme ("") comme modèle. Vous pouvez également créer une règle d'accès de connexion qui s'applique lorsqu'il n'existe aucune règle d'accès de connexion avec un modèle correspondant en spécifiant AnyOtherOriginScheme ("*") comme modèle.

Remarque
Si le code n'envoie pas le modèle URI comme preuve, l'accès au site d'origine est autorisé à l'aide de n'importe quel modèle.

L'exemple de code suivant illustre la création de NetCodeGroup et l'ajout d'objets CodeConnectAccess pour le code téléchargé à l'aide du modèle HTTP.

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

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence