Свойства клиентского канала

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

В следующей таблице приведены свойства клиентского канала, которые можно задать.

Свойство	Описание	Типы, поддерживающие это свойство
allowAutoRedirect	Логическое значение, указывающее, доступна ли автоматическая обработка серверных перенаправлений.	HttpChannel HttpClientChannel
clientConnectionLimit	Целое число, указывающее число подключений, которое можно одновременно отрыть для заданного сервера. Значение по умолчанию — 2.	HttpChannel HttpClientChannel
connectionGroupName	Строка, задающая имя, которое следует использовать в качестве имени группы подключений на сервере, если значение unsafeAuthenticatedConnectionSharing равно true. Данное свойство не учитывается, если значение unsafeAuthenticatedConnectionSharing не равно true. Если параметр задан, убедитесь, что это имя сопоставляется только одному прошедшему проверку подлинности пользователю. Это свойство поддерживается только в .NET Framework 1.1 или более поздних версий на следующих платформах: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional и в семействе Windows Server 2003.	HttpChannel HttpClientChannel
connectionTimeout	Целое число, указывающее максимальное время ожидания успешного подключения в миллисекундах. Значение 0 или -1 указывает на бесконечное время ожидания. Значение по умолчанию — Infinite.	IpcChannel IpcClientChannel
credentials	Объект, реализующий интерфейс ICredentials, который представляет удостоверение клиента.	HttpChannel HttpClientChannel
domain	Строка, которая задает имя домена для использования с именем пользователя (свойство username) и паролем (свойство password) при проверке подлинности в серверном канале.	HttpClientChannel TcpClientChannel
password	Строка, задающая пароль для использования с именем пользователя (свойство username) и доменом (свойство domain) при проверке подлинности в серверном канале.	HttpClientChannel TcpClientChannel
proxyName	Строка, которая задает имя, используемое прокси-объектом при вызовах удаленного сервера. По умолчанию используется имя узла клиентского компьютера.	HttpChannel HttpClientChannel
proxyPort	Целое число, задающее номер порта, через который прокси-объект передает вызовы на удаленный сервер. По умолчанию во время выполнения выбирается доступный порт без дополнительных привилегий.	HttpChannel HttpClientChannel
retryCount	Целое число, задающее число повторных попыток удаленного вызова, если первый вызов выполнить не удалось. Значение по умолчанию — 1.	TcpClientChannel
servicePrincipalName	Строка, задающая значение servicePrincipalName для проверки подлинности Kerberos. Значение по умолчанию — NULL.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
socketCachePolicy	Член перечисления SocketCachePolicy, который определяет, измеряется ли время, задаваемое свойством socketCacheTimeout, с момента, когда сокет использовался в последний раз или с момента создания сокета. Значение по умолчанию — Default.	TcpClientChannel
socketCacheTimeout	Целое значение, задающее время (в секундах), по истечении которого сокет удаляется из кэша объекта TcpClientChannel. Значение по умолчанию — пять секунд.	TcpClientChannel
timeout	Целое значение, задающее время ожидания перед истечением срока действия запроса в миллисекундах. Значение 0 или -1 указывает на бесконечное время ожидания. Значение по умолчанию — Infinite.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
tokenImpersonationLevel	Значение типа TokenImpersonationLevel. Это свойство определяет, каким образом клиент проходит проверку подлинности на сервере. Значение по умолчанию — None, если только свойство secure не равно true; в последнем случае значение по умолчанию равно Identification.	TcpChannel TcpClientChannel
unsafeAuthenticatedConnectionSharing	Логическое значение, указывающее, будет ли разрешено совместное использование высокоскоростного подключения с проверкой подлинности NTLM. Если значение равно true, значение connectionGroupName должно соответствовать только одному прошедшему проверку подлинности пользователю. Это свойство не учитывается, если значение useAuthenticatedConnectionSharing равно true. Это свойство поддерживается только в .NET Framework 1.1 или более поздних версий на следующих платформах: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional и Windows Server 2003.	HttpChannel HttpClientChannel
useAuthenticatedConnectionSharing	Логическое значение, указывающее, использует ли серверный канал прошедшие проверку подлинности подключения повторно вместо проверки подлинности каждого входящего вызова. По умолчанию это значение равно true, если значение useDefaultCredentials также равно true; в противном случае это значение равно false, что означает, что каждый вызов проходит проверку подлинности, если сервер требует проверки подлинности. Это также относится к аналогичной программной реализации, для которой нужно либо создать объект, реализующий интерфейс IDictionary, установить свойство credentials равным CredentialCache.DefaultCredentials и передать это значение в приемник канала, либо воспользоваться объектом IDictionary, возвращаемым методом ChannelServices.GetChannelSinkProperties. Эта пара "имя-значение" поддерживается только в .NET Framework 1.1 или более поздних версий на следующих платформах: Microsoft Windows 98, Windows NT 4.0, Windows Millennium Edition (Windows Me), Windows 2000, Windows XP Home Edition, Windows XP Professional и Windows Server 2003.	HttpChannel HttpClientChannel
useDefaultCredentials	Логическое значение, которое определяет, нужно ли при проверке подлинности в серверном канале использовать учетные данные удостоверения, связанного с текущим потоком.	HttpChannel HttpClientChannel
username	Строка, задающая имя пользователя для использования с паролем (свойство password) и доменом (свойство domain) при проверке подлинности в серверном канале.	HttpClientChannel TcpClientChannel

Примечание
В Windows 98 и Windows Me нет ИД безопасности для идентификации имени группы подключений проверки подлинности. Поэтому на этих платформах имеется только одно имя группы подключений.

Примечание

Если приложение должно передавать реализацию интерфейса ICredentials или явные значения username, password и domain в свойствах HttpClientChannel, можно включить совместное использование подключения проверки подлинности, задав свойство unsafeAuthenticatedConnectionSharing и connectionGroupName , а также проверив, что значение connectionGroupName соответствует только одному прошедшему проверку подлинности пользователю.

См. также

Задачи

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

Справочник

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

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

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