Элемент <wellknown> (экземпляр клиента)

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

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

Schema Hierarchy

<configuration>
  Элемент <system.runtime.remoting>
    Элемент <application>
      Элемент <client>
        Элемент <wellknown> (экземпляр клиента)

Синтаксис

<wellknown  
   url="url" 
   displayName="displayName" 
   type="type,assembly"
/>

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

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

Атрибуты

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

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

Нет.

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

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

Примеры

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

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown 
               type="RemoteType, RemoteAssembly"
               url="http://computername:8080/RemoteType.rem"
            />
         </client>
         <channels>
            <channel
               ref="http" 
               port="0"
            />
         </channels>
      </application>
   </system.runtime.remoting>
</configuration>

См. также

Справочник

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

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

Активация удаленных объектов

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