Canal de cliente (Propiedades de)

Este tema es específico de una tecnología heredada que se mantiene para la compatibilidad con versiones anteriores con aplicaciones existentes y no se recomienda para nuevo desarrollo. Las aplicaciones distribuidas se deberían desarrollar utilizando  Windows Communication Foundation (WCF).

En la tabla siguiente se muestran las propiedades del canal de cliente que se pueden especificar.

Propiedad	Descripción	Tipos que son compatibles con esta propiedad
allowAutoRedirect	Valor booleano que indica si el control automático de las redirecciones del servidor está habilitado.	HttpChannel HttpClientChannel
clientConnectionLimit	Un entero que indica cuántas conexiones se pueden abrir simultáneamente a un servidor determinado. El valor predeterminado es 2.	HttpChannel HttpClientChannel
connectionGroupName	Una cadena que especifica el nombre que se debe utilizar como el nombre del grupo de conexión en el servidor si el valor unsafeAuthenticatedConnectionSharing está establecido en true. Esta propiedad se ignora siunsafeAuthenticatedConnectionSharing no está establecido en true. Si se especifica, asegúrese de que este nombre asigna solamente a un usuario autenticado. Esta propiedad solamente se admite en la versión 1.1 o superiores de .NET Framework en las siguientes plataformas: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional y la familia de Windows Server 2003.	HttpChannel HttpClientChannel
connectionTimeout	Un entero que especifica el número de milisegundos que hay que esperar para que se realice una conexión correcta. 0 o -1 indican un período de tiempo de espera infinito. El valor predeterminado es Infinite.	IpcChannel IpcClientChannel
credenciales	Un objeto que implementa la interfaz ICredentials que representa la identidad del cliente.	HttpChannel HttpClientChannel
dominio	Una cadena que especifica el nombre de dominio que se debe utilizar, junto con el nombre de usuario especificado por username y la contraseña especificada por password, al autenticar a un canal de servidor.	HttpClientChannel TcpClientChannel
contraseña	Una cadena que especifica la contraseña que se debe utilizar, junto con el nombre de usuario especificado por username y el dominio especificado por domain, al autenticar a un canal de servidor.	HttpClientChannel TcpClientChannel
proxyName	Una cadena que especifica el nombre utilizado por el proxy al realizar llamadas al servidor remoto. De forma predeterminada, se utiliza el nombre de host del equipo cliente.	HttpChannel HttpClientChannel
proxyPort	Un entero que especifica el número de puerto desde el cual el proxy realiza las llamadas al servidor remoto. De forma predeterminada, en el tiempo de ejecución se elige un puerto disponible y sin privilegios.	HttpChannel HttpClientChannel
retryCount	Un entero que especifica el número de veces que el cliente repite una llamada remota en la que inicialmente se produce un error. El valor predeterminado es 1.	TcpClientChannel
servicePrincipleName	Una cadena que especifica servicePrincipalName para la autenticación de Kerberos. El valor predeterminado es null.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
socketCachePolicy	Un miembro de la enumeración SocketCachePolicy que determina si la hora especificada por la propiedad socketCacheTimeout se mide a partir de la hora en la que se creó un socket o cuando éste se usó por última vez. El valor predeterminado es Default.	TcpClientChannel
socketCacheTimeout	Un entero que especifica el tiempo, en segundos, tras el cual se quita un socket de la caché mantenida por un objeto TcpClientChannel. El valor predeterminado es cinco segundos.	TcpClientChannel
tiempo de espera	Un entero que especifica el número de milisegundos que hay que esperar antes de que se agote el tiempo de espera de una solicitud. 0 o -1 indican un período de tiempo de espera infinito. El valor predeterminado es Infinite.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
tokenImpersonationLevel	Un valor de tipo TokenImpersonationLevel. Esta propiedad especifica cómo se autentica el cliente con el servidor. El valor predeterminado es None, a menos que la propiedad secure se establezca a true, en cuyo caso el valor predeterminado es Identification.	TcpChannel TcpClientChannel
unsafeAuthenticatedConnectionSharing	Un valor booleano que indica si se permite el uso compartido de las conexiones de alta velocidad autenticadas por NTLM. Si este valor está establecido en true, el valor connectionGroupName debe asignar solamente a un usuario autenticado. Esta propiedad se ignora si el valor useAuthenticatedConnectionSharing está establecido a true. Esta propiedad solamente se admite en la versión 1.1 o superiores de .NET Framework en las siguientes plataformas: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional y Windows Server 2003.	HttpChannel HttpClientChannel
useAuthenticatedConnectionSharing	Un valor booleano que indica si el canal de servidor reutiliza las conexiones autenticadas en lugar de autenticar cada llamada entrante. De forma predeterminada, este valor está establecido en true si el valor useDefaultCredentials también está establecido en true; de lo contrario, el valor está establecido en false, lo que significa que se autentica cada llamada si el servidor requiere la autenticación. Esto también se aplica al equivalente de programación, que se logra creando un objeto que implementa IDictionary, estableciendo la propiedad credentials en CredentialCache.DefaultCredentialsy pasando ese valor al receptor de canal, o utilizando el formulario devuelto IDictionary del método ChannelServices.GetChannelSinkProperties. Esta propiedad solamente se admite en la versión 1.1 o superiores de .NET Framework en las siguientes plataformas: Microsoft Windows 98, Windows NT 4.0, Windows Millennium Edition (Windows Me), Windows 2000, Windows XP Home Edition, Windows XP Professional y Windows Server 2003.	HttpChannel HttpClientChannel
useDefaultCredentials	Un valor booleano que especifica si se presentan las credenciales para la identidad asociada a la conversación actual al autenticarla en un canal de servidor.	HttpChannel HttpClientChannel
username	Una cadena que especifica el nombre de usuario que se debe utilizar, junto con la contraseña especificada por password y el dominio especificado por domain, al autenticar a un canal de servidor.	HttpClientChannel TcpClientChannel

Nota:
En Windows 98 y Windows Me, no hay ningún Id. de seguridad para identificar el nombre de grupo de conexión de autenticación. Por consiguiente, en estas plataformas hay un nombre de grupo de conexión.

Nota:

Si desea que su aplicación pase la implementación ICredentials o los valores explícitos username, password y domain en las propiedades HttpClientChannel, también puede habilitar la conexión compartida de autenticación al establecer la propiedad unsafeAuthenticatedConnectionSharing a verdadera y estableciendo la propiedad connectionGroupName asegurándose de que los mapas de valor connectionGroupName solo reconocen a un usuario autenticado.

Vea también

Tareas

Cómo: Configurar un canal en un archivo de configuración
Cómo: Configurar un canal mediante programación

Referencia

Esquema de configuración de la comunicación remota

Conceptos

Configuración de aplicaciones remotas
Configuración de objetos remotos
Configuración de objetos remotos