Элемент <customErrors>

  • Статья

Этот раздел относится к технологии прежних версий, которая сохраняется для обеспечения обратной совместимости с существующими приложениями и не рекомендуется для разработки новых приложений. Сейчас распределенные приложения следует создавать с помощью  Windows Communication Foundation (WCF).

Указывает, возвращают ли каналы сервера в этом домене приложения локальным или удаленным вызывающим объектам фильтрованные или полные сведения об исключениях. Этот элемент может встречаться в файле конфигурации приложения или в файле конфигурации компьютера. Этот элемент поддерживается в платформе .NET Framework версии 1.1 или более поздней версии в операционной системе Microsoft Windows 98 или более поздней версии.

Schema Hierarchy

<configuration>
  Элемент <system.runtime.remoting>
    Элемент <customErrors>

Синтаксис

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

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание

mode

Обязательный атрибут.

Указывает, возвращают ли каналы сервера в этом домене приложения локальным или удаленным вызывающим объектам фильтрованные или полные сведения об исключениях. Значение по умолчанию — RemoteOnly, которое возвращает полные сведения об исключении (включая трассировку стека) только вызывающим объектам, расположенным на том же компьютере, что и сервер.

Дочерние элементы

Нет.

Родительские элементы

Элемент Описание

configuration

Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями платформы .NET Framework.

system.runtime.remoting

Содержит сведения об удаленных объектах и каналах.

Замечания

Полные сведения об исключении включают точное исключение сервера и трассировку стека сервера. Фильтрованные сведения включают стандартное исключение удаленного доступа, но не трассировку стека сервера.

В приведенной ниже таблице приведены три значения свойства канала сервера, которые указывают, какие вызывающие объекты получают сведения об исключении и сведения какого типа они получают.

Значение Описание

Off

Все вызывающие объекты получают полные сведения об исключении.

On

Все вызывающие объекты получают фильтрованные сведения об исключении.

RemoteOnly

Локальные вызывающие объекты получают полные сведения об исключении. Удаленные вызывающие объекты получают фильтрованные сведения об исключении.

Примеры

Приведенный ниже файл конфигурации содержит предназначенные для системы удаленного взаимодействия .NET Framework указания зарегистрировать канал сервера от имени домена клиентского приложения, чтобы клиентский домен мог передавать делегат для использования в качестве обратного вызова. Задание значения <customErrors mode="Off"/> приводит к тому, что сервер получает полные сведения об исключении, включая трассировку стека, если во время обратного вызова на клиенте возникает исключение.

<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>

См. также

Справочник

Схема параметров удаленного взаимодействия
System.Runtime.Remoting.RemotingConfiguration.CustomErrorsEnabled(System.Boolean)

Дата сборки: 2010-02-13