Общие свойства канала

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

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

Свойство Описание Типы, поддерживающие это свойство

name

Строка, задающее имя этого канала. Если имя не указано, используется имя по умолчанию, которое зависит от типа.

HttpChannel: "http"

HttpClientChannel: "http client"

HttpServerChannel: "http server"

TcpChannel: "tcp"

TcpClientChannel: "tcp client"

TcpServerChannel: "tcp server"

IpcChannel: "ipc"

IpcClientChannel: "ipc client"

IpcServerChannel: "ipc server"

Каждый канал должен иметь уникальное имя. Присвойте этому свойству пустую строку ("" или String.Empty), если имена должны игнорироваться, но нужно избежать конфликтов имен. Система позволяет задать произвольное число каналов, свойство name которых имеет значение String.Empty. Это свойство служит для получения конкретного канала при вызове метода ChannelServices.GetChannel. Дополнительные сведения см. в разделе Каналы.

HttpChannel

HttpServerChannel

HttpClientChannel

TcpChannel

TcpClientChannel

TcpServerChannel

IpcChannel

IpcClientChannel

IpcServerChannel

machineName

Строка, которая задает имя компьютера, используемое с текущим каналом. При использовании с серверным каналом переопределяет элемент useIpAddress.

Bb397840.note(ru-ru,VS.100).gifПримечание
Рекомендуется использовать DNS-имя компьютера, но если IP-адрес конкретной сетевой карты (обычно беспроводной) часто меняется, необходимо настроить приложение таким образом, чтобы для поиска компьютера в DNS при удаленном взаимодействии использовался параметр machineName. Если же выполнить разрешение имени компьютера за разумное время не удается (или вообще не удается), и у компьютера имеется более одной сетевой карты, как физической, так и виртуальной (это часто происходит при использовании коммутируемого соединения и сетевого адаптера VPN), необходимо задать в качестве значения свойства machineName IP-адрес сетевой карты, которая в настоящий момент используется для данного соединения.

HttpChannel

HttpClientChannel

HttpServerChannel

TcpChannel

TcpClientChannel

TcpServerChannel

priority

Целое число, обозначающее приоритет, назначенный данному каналу. Чем больше число, тем выше вероятность, что этот канал будет выбран для подключения первым. Значение приоритета по умолчанию равно 1; допускаются отрицательные числа.

HttpChannel

HttpServerChannel

HttpClientChannel

TcpChannel

TcpClientChannel

TcpServerChannel

IpcChannel

IpcClientChannel

IpcServerChannel

secure (TcpChannel)

Логическое значение (true или false), которое определяет, является ли взаимодействие по этому каналу защищенным. Значение по умолчанию — false. Если установлено значение true, для свойства tokenImpersonationLevel устанавливается значение Identification, а для свойства protectionLevelEncryptAndSign. Обратите внимание, что защищенный канал TcpClientChannel может подключаться только к защищенному каналу TcpServerChannel, а незащищенный канал TcpClientChannel — только к незащищенному каналу TcpServerChannel.

Bb397840.note(ru-ru,VS.100).gifПримечание
Если компьютер сервера работает под управлением Windows 95, Windows 98 или Windows Me, канал TcpServerChannel невозможно сделать защищенным.

TcpChannel

TcpClientChannel

TcpServerChannel

secure (IpcChannel)

Логическое значение (true или false), которое определяет, является ли взаимодействие по этому каналу защищенным. Значение по умолчанию — false. Если свойство имеет значение true, то свойство tokenImpersonationLevel устанавливается равным Identification. Обратите внимание, что защищенный канал IpcClientChannel может подключаться как к защищенному, так и к незащищенному каналу IpcServerChannel, а незащищенный канал IpcClientChannel — только к незащищенному каналу IpcServerChannel.

IpcChannel

IpcClientChannel

IpcServerChannel

protectionLevel

Значение типа ProtectionLevel. Значение по умолчанию — None, если только свойство secure не равно true; в последнем случае значение по умолчанию равно EncryptAndSign. Свойство secure необходимо устанавливать равным true, чтобы свойство ProtectionLevel могло иметь значение, отличное от None.

Обратите внимание, что None является единственным значением, совместимым с Windows 95, Windows 98 и Windows Me.

TcpClientChannel

TcpServerChannel

См. также

Задачи

Как настроить канал в файле конфигурации
Как настроить канал программным образом

Справочник

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

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

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