Élément <customErrors>

Cette rubrique est spécifique à la technologie héritée assurant la compatibilité descendante avec des applications existantes et n'est pas recommandée en cas de nouveau développement. Les applications distribuées doivent maintenant être développées à l'aide de Windows Communication Foundation (WCF)

Indique si les canaux serveur de ce domaine d'application retournent des informations filtrées ou des informations complètes sur les exceptions aux appelants locaux ou distants. Cet élément peut se trouver dans le fichier de configuration de l'ordinateur ou dans le fichier de configuration de l'application. Cet élément est pris en charge dans le .NET Framework version 1.1 ou ultérieurement sous Microsoft Windows 98 ou une version ultérieure.

Schema Hierarchy

<configuration>
  Élément <system.runtime.remoting>
    Élément <customErrors>

Syntaxe

<customErrors  
   mode="Off|On|RemoteOnly" 
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
mode	Attribut requis. Indique si les canaux serveur de ce domaine d'application retournent des informations filtrées ou des informations complètes sur les exceptions aux appelants locaux ou distants. La valeur par défaut est RemoteOnly, qui retourne des informations complètes sur les exceptions (y compris la trace de la pile) uniquement aux appelants sur le même ordinateur que le serveur.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
configuration	Élément racine de chaque fichier de configuration utilisé par le common language runtime et les applications .NET Framework.
system.runtime.remoting	Contient des informations sur les canaux et les objets distants.

Notes

Les informations complètes sur les exceptions comprennent l'exception serveur exacte et la trace de la pile serveur. Les informations filtrées comprennent une exception de communication à distance standard, mais aucune trace de la pile serveur.

Le tableau suivant décrit les trois valeurs de propriété de canal serveur qui spécifient les appelants recevant des informations sur les exceptions et le type d'informations qu'ils reçoivent.

Valeur	Description
Off	Tous les appelants reçoivent des informations complètes sur les exceptions.
On	Tous les appelants reçoivent des informations filtrées sur les exceptions.
RemoteOnly	Les appelants locaux reçoivent des informations complètes sur les exceptions ; les appelants distants reçoivent des informations filtrées sur les exceptions.

Exemple

L'exemple de fichier de configuration suivant indique au système .NET Framework Remoting d'inscrire un canal serveur au nom d'un domaine d'application client afin que le domaine client puisse passer un délégué qui sera utilisé comme rappel. Le fait de spécifier <customErrors mode="Off"/> entraîne la réception des informations complètes sur les exceptions par le serveur, y compris la trace de la pile, si une exception se produit sur le client lors du rappel.

<configuration>

<system.runtime.remoting>

<application>

<client url="http://computername:8080">

<activated type="ClientActivatedType, RemoteType"/>

</client>

<channels>

<channel ref="http" port="0">

<serverProviders>

<formatter ref="soap" typeFilterLevel="Full"/>

<formatter ref="binary" typeFilterLevel="Full"/>

</serverProviders>

</channel>

</channels>

</application>

<customErrors mode="Off"/>

</system.runtime.remoting>

</configuration>

Voir aussi

Référence

Schéma des paramètres de communication à distance
System.Runtime.Remoting.RemotingConfiguration.CustomErrorsEnabled(System.Boolean)

Date de génération : 2010-02-13