Partager via


<customErrors>, élément

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.

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

<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(e).

É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 d'accès distant 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 quels appelants reçoivent 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 distant .NET Framework d'inscrire un canal serveur au nom d'un domaine d'application client afin que le domaine client puisse passer un délégué à utiliser 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

RemotingConfiguration.CustomErrorsEnabled
Schéma des paramètres d'accès distant