Элемент <wellknown> (экземпляр службы)

Статья
02/17/2011

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

Содержит сведения об активируемых сервером (хорошо известных) объектах, которые приложение предоставляет клиентам. Этот элемент может встречаться в файле конфигурации приложения и в файле конфигурации компьютера.

Schema Hierarchy

<configuration>
  Элемент <system.runtime.remoting>
    Элемент <application>
      Элемент <service>
        Элемент <wellknown> (экземпляр службы)

Синтаксис

<wellknown  
   mode="Singleton|SingleCall"
   displayName="name"
   type="type,assembly" 
      objectUri="objectUri" 
/>

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

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

Атрибуты

Атрибут	Описание
mode	Обязательный атрибут. Задает тип объекта — Singleton или SingleCall. Можно выбрать только один вариант. Дополнительные сведения см. в разделе Активация.
objectUrl	Обязательный атрибут. Задает конечную точку универсального кода ресурса (URI) объекта.
type	Обязательный атрибут. Задает полное имя типа объекта и имя сборки реализации типа. Включает сведения о версии, языке и региональных параметрах, а также об открытом ключе, если соответствующая сборка принадлежит к глобальному кэшу сборок.
displayName	Необязательный атрибут. Используется средством настройки .NET Framework для создания списка активируемых сервером объектов, для публикации которых зарегистрирован сервер. Система удаленного взаимодействия .NET Framework не использует этот атрибут.

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

Нет.

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

Элемент	Описание
application	Содержит сведения об удаленных объектах, которые использует и предоставляет приложение.
configuration	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями платформы .NET Framework.
service	Содержит объекты, предоставляемые приложением другим доменам приложений и контекстам.
system.runtime.remoting	Содержит сведения об удаленных объектах и каналах.

Замечания

Когда объект размещается в службах IIS, атрибут objectUri должен иметь расширение .soap или .rem, чтобы запрос перенаправлялся обработчику удаленного взаимодействия .NET Framework IHttpHandler.

Примеры

В следующем файле конфигурации объявляются активируемый сервером (хорошо известный) тип, универсальный код ресурса (URI), по которому его можно найти, и режим WellKnownObjectMode, который определяет порядок активации экземпляров.

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
            <wellknown 
               type="ServerActivatedType, RemoteAssembly" 
               objectUri="ServerType.rem" 
               mode="Singleton" 
            />
         </service>
      </application>
   </system.runtime.remoting>
</configuration>

См. также

Справочник

Схема параметров удаленного взаимодействия

Основные понятия

Активация удаленных объектов
Конфигурация удаленных приложений

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

Поделиться через