Configuration des applications Internet

L'élément de configuration <system.net> contient des informations sur la configuration réseau des applications. Il permet de définir des serveurs proxy, des paramètres de gestion des connexions et d'inclure des modules de demande et d'authentification personnalisés dans votre application.

L'élément <defaultProxy> définit le serveur proxy retourné par la classe GlobalProxySelection. Toute HttpWebRequest dont la propriété Proxy n'a pas de valeur spécifique utilise le proxy par défaut. Outre la définition de l'adresse proxy, vous pouvez créer une liste d'adresses serveur qui n'utiliseront pas le proxy et spécifier que le proxy ne doit pas être utilisé pour les adresses locales.

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

L'exemple suivant définit l'adresse du serveur proxy par défaut à http://proxyserver, indique que le proxy ne doit pas être utilisé pour les adresses locales et précise que toutes les demandes effectuées 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> pour configurer le nombre de connexions persistantes pouvant être établies à un serveur spécifique ou à tous les autres serveurs. L'exemple suivant configure l'application de manière à utiliser 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="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 à l'aide de l'élément <authenticationModules>. 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>

Utilisez l'élément <webRequestModules> pour configurer votre application de sorte qu'elle utilise des modules de protocole personnalisés pour demander des informations aux ressources Internet. Les modules spécifiés doivent implémenter l'interface IWebRequestCreate. Vous pouvez ignorer HTTP, HTTPS et les modules de demande 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

Accès à Internet | Schéma des paramètres réseau | Configuration d'applications