<customErrors> (Elemento)
Este tema es específico de una tecnología heredada que se mantiene para la compatibilidad con versiones anteriores con aplicaciones existentes y no se recomienda para nuevo desarrollo. Las aplicaciones distribuidas se deberían desarrollar utilizando Windows Communication Foundation (WCF).
Indica si los canales del servidor de este dominio de aplicaciones devuelven información de excepciones filtrada o completa a llamadores locales o remotos. Este elemento puede aparecer en un archivo de configuración del equipo o en un archivo de configuración de la aplicación. Este elemento se admite en la versión 1.1 de .NET Framework o posterior en Microsoft Windows 98 o posterior.
Schema Hierarchy
<configuration>
<system.runtime.remoting> (Elemento)
<customErrors> (Elemento)
Sintaxis
<customErrors
mode="Off|On|RemoteOnly"
/>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
mode |
Atributo necesario. Indica si los canales del servidor de este dominio de aplicaciones devuelven información de excepciones filtrada o completa a llamadores locales o remotos. El valor predeterminado es RemoteOnly, que devuelve información de excepciones completa (incluido el seguimiento de la pila) solo a llamadores que se encuentren en el mismo equipo que el servidor. |
Elementos secundarios
Ninguno.
Elementos primarios
| Elemento | Descripción |
|---|---|
configuration |
Elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework. |
system.runtime.remoting |
Contiene información sobre canales y objetos remotos. |
Notas
La información completa sobre las excepciones incluye la excepción de servidor exacta y el seguimiento de pila del servidor. La información filtrada incluye una excepción de interacción remota estándar, pero no el seguimiento de pila del servidor.
En la tabla siguiente se describen los tres valores de propiedades del canal del servidor, que especifican qué llamadores reciben información de excepciones y el tipo de información que reciben.
| Valor | Descripción |
|---|---|
Off |
Todos los llamadores reciben información completa sobre excepciones. |
On |
Todos los llamadores reciben información filtrada sobre excepciones. |
RemoteOnly |
Los llamadores locales reciben información completa sobre excepciones; los llamadores locales reciben información filtrada sobre excepciones. |
Ejemplo
En el siguiente ejemplo de archivo de configuración se indica al sistema remoto .NET Framework que registre un canal de servidor en nombre de un dominio de aplicación cliente para que el dominio de cliente pueda pasar un delegado que se utilice como devolución de llamada. Al especificar <customErrors mode="Off"/> el servidor recibe información de excepción completa, que incluye la pila de seguimiento, si ocurre una excepción en el cliente durante la devolución de la llamada.
<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>
Vea también
Referencia
Esquema de configuración de la comunicación remota
System.Runtime.Remoting.RemotingConfiguration.CustomErrorsEnabled(System.Boolean)
Fecha de compilación: 2010-02-13