Конфигурирование и настройка Microsoft ASP.NET

Использование раздела <channel>


Ниже показан синтаксис раздела <channel>.

<channels> <channel id="Channel ID" type="Channel Type, Channel Assembly" displayName="Name" customChannelProperty="Value" delayLoadAsClientChannel="true | false" /> </channels>

В таблице 6.17 содержится перечень свойств раздела <channel>.

Таблица 6.17. Свойства <channel>

СвойствоОписание
idОпределяет строку, используемую для ссылки на данный шаблон при объявлении канала.
typeОпределяет полный тип и имя сборки данного объекта.
displayNameОпределяет имя, используемое в .NET Framework Configuration Tool.
customChannelPropertyОпределяет собственное свойство канала.
delayLoadAsClientChannelОпределяет загрузку канала при отсутствии регистрации канала клиентом.

true Канал будет загружен во время выполнения.

false Канал загружен не будет.

Два подраздела этого раздела называются <serverProviders> и <clientProviders>.

  • <clientProviders>. Содержит провайдеров приемников каналов, которые используются в цепочке вызовов клиентских приемников канала по умолчанию.
  • <serverProviders>. Содержит провайдеров приемников каналов, которые используются в цепочке вызовов серверных приемников канала по умолчанию.

Оба раздела используют элементы <formatter> и <provider>.

Использование элемента <formatter>. Элемент <formatter> определяет провайдера приемника канала для приемника-форматера, который будет вставлен в цепочку приемников канала. Ниже приведен синтаксис элемента <formatter>.

<formatter ref="Formatter Template ID" type="FormatterSinkType, FormatterAssembly" customFormatterProperty="customProperty" includeVersions="true | false" strictBinding="true | false" typeFilterLevel="Low | High" />

В таблице 6.18 содержится перечень свойств этого раздела.

Таблица 6.18. Свойства <formatter>

СвойствоОписание
refОпределяет ID используемого шаблона провайдера приемника-форматера.
typeОпределяет полное имя типа и имя сборки, содержащей реализацию провайдера.
customFormatterPropertyОпределяет собственное свойство форматера.
includeVersionsОпределяет, включает ли отправляющий форматер полную информацию о типе и версии сборки.

true Полная информация о типе и сборки включается.

false Полная информация о типе и сборки не включается.

strictBindingОпределяет, будет ли принимающий форматер использовать полную информацию о версии, или он будет полагаться только на имя типа и сборки.

true Принимающий форматер использует полную информацию о версии.

false Принимающий форматер не использует полную информацию о версии.

typeFilterLevelОпределяет уровень автоматической десериализации, используемой форматером.
<
Использование элемента <provider>. Элемент <provider> определяет провайдера приемника канала для приемника канала, который будет вставлен в цепочку приемников канала. Ниже приведен синтаксис элемента <provider>.

<provider ref="Provider Template ID" type="Provider Type, Provider Assembly" customChannelSinkProperty="customProperty" />

В таблице 6.19 содержится перечень свойств <provider>.

Таблица 6.19. Свойства <provider>СвойствоОписание
refОпределяет ID шаблона провайдера.
typeОпределяет полное имя типа и имя сборки, содержащей реализацию провайдера.
customChannelSinkPropertyОпределяет собственное свойство приемника канала.

Содержание раздела