Configuration des applications Internet

  • Article

L’élément de configuration <system.Net> (Paramètres réseau) contient des informations de configuration réseau pour les applications. En utilisant l’élément <system.Net> (Paramètres réseau), vous pouvez définir des serveurs proxy, définir des paramètres de gestion de connexion, et inclure des modules de requête et d’authentification personnalisés dans votre application.

L’élément <defaultProxy> (Paramètres réseau) définit le serveur proxy retourné par la classe GlobalProxySelection. Tout HttpWebRequest dont la propre propriété Proxy n’a pas une valeur spécifique utilise le proxy par défaut. En plus de définir l’adresse du proxy, vous pouvez créer une liste d’adresses de serveurs qui n’utiliseront pas le serveur proxy, et vous pouvez indiquer que le proxy ne doit pas être utilisé pour les adresses locales.

Il est important de noter que les paramètres Internet du système sont combinés avec les paramètres de configuration, ces derniers étant prioritaires.

L’exemple suivant définit http://proxyserver comme adresse du serveur proxy par défaut, indique que le proxy ne doit pas être utilisé pour les adresses locales, et spécifie que toutes les requêtes aux serveurs situés dans le domaine contoso.com doivent ignorer le proxy.

<configuration>  
    <system.net>  
        <defaultProxy>  
            <proxy  
                usesystemdefault = "false"  
                proxyaddress = "http://proxyserver:80"  
                bypassonlocal = "true"  
            />  
            <bypasslist>  
                <add address="http://[a-z]+\.contoso\.com/" />  
            </bypasslist>  
        </defaultProxy>  
    </system.net>  
</configuration>

Utilisez l’élément <connectionManagement> (Paramètres réseau) pour configurer le nombre de connexions persistantes pouvant être établies avec un serveur spécifique ou avec tous les autres serveurs. L’exemple suivant configure l’application pour qu’elle utilise deux connexions persistantes au serveur www.contoso.com, quatre connexions persistantes au serveur avec l’adresse IP 192.168.1.2, et une connexion persistante à tous les autres serveurs.

<configuration>  
    <system.net>  
        <connectionManagement>  
            <add address="http://www.contoso.com" maxconnection="2" />  
            <add address="192.168.1.2" maxconnection="4" />  
            <add address="*" maxconnection="1" />  
        </connectionManagement>  
    </system.net>  
</configuration>

Les modules d’authentification personnalisés sont configurés avec l’élément <authenticationModules> (Paramètres réseau). Ils doivent implémenter l’interface IAuthenticationModule.

L’exemple suivant configure un module d’authentification personnalisé.

<configuration>  
    <system.net>  
        <authenticationModules>  
            <add type="MyAuthModule, MyAuthModule.dll" />  
        </authenticationModules>  
    </system.net>  
</configuration>

Vous pouvez utiliser l’élément <webRequestModules> (Paramètres réseau) pour configurer votre application afin qu’elle utilise des modules propres au protocole personnalisés pour demander des informations auprès de ressources Internet. Les modules spécifiés doivent implémenter l’interface IWebRequestCreate. Vous pouvez substituer les modules HTTP, HTTPS et de requête de fichier par défaut en spécifiant votre module personnalisé dans le fichier de configuration, comme dans l’exemple suivant.

<configuration>  
    <system.net>  
        <webRequestModules>  
            <add  
                prefix="HTTP"  
                type = "MyHttpRequest.dll, MyHttpRequestCreator"  
            />  
        </webRequestModules>  
    </system.net>  
</configuration>

Voir aussi