Элемент <client>

Статья
02/17/2011

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

Содержит объекты, которые используются приложением. Поскольку атрибут url требуется для активируемых клиентом типов и не требуется для активируемых сервером типов, для каждого уникального URL-адреса будет использоваться собственный элемент client, содержащий активируемые клиентом типы, которые публикуются в этом расположении. Этот элемент может встречаться в файле конфигурации приложения и в файле конфигурации компьютера.

Schema Hierarchy

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

Синтаксис

<client
   url="url"
   displayName="displayName"
/>

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

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

Атрибуты

Атрибут	Описание
url	Этот атрибут не является обязательным, если удаленные типы являются типами, активируемыми сервером; если удаленные типы активируются клиентом, то этот атрибут является обязательным.
displayName	Используется the .NET Framework Configuration Tool для создания списка клиентских приложений. Система удаленного взаимодействия .NET Framework не использует этот атрибут.

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

Элемент	Описание
wellknown	Содержит сведения об активируемых сервером (хорошо известных) объектах, которые требуется использовать в приложении. Может указываться в элементе client один или несколько раз.
activated	Содержит сведения об активируемых клиентом объектах, которые требуется использовать в приложении. Может указываться в элементе client один или несколько раз.

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

Элемент	Описание
application	Содержит сведения об удаленных объектах, которые использует и предоставляет приложение.
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>

См. также

Справочник

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

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

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

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

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