Propriétés de canal client

Le tableau suivant indique les propriétés de canal client qui peuvent être spécifiées.

Propriété	Description	Types qui prennent en charge cette propriété
allowAutoRedirect	Valeur Boolean qui indique si la gestion automatique des redirections du serveur est activée.	HttpChannel HttpClientChannel
clientConnectionLimit	Entier qui indique le nombre de connexions à un serveur donné pouvant être ouvertes simultanément. La valeur par défaut est 2.	HttpChannel HttpClientChannel
connectionGroupName	Chaîne qui spécifie le nom devant servir de nom de groupe de connexions sur le serveur si la valeur unsafeAuthenticatedConnectionSharing est true. Si unsafeAuthenticatedConnectionSharing a la valeur true, cette propriété demeure sans effet. Assurez-vous dans ce cas que ce nom ne correspond qu'à un seul utilisateur authentifié. Cette propriété n'est prise en charge que par la version 1.1 et supérieure du .NET Framework sur les plateformes suivantes : Windows 98, Windows NT 4.0, Windows Millennium, Windows 2000, Windows XP Édition familiale, Windows XP Professionnel et la famille Windows Server 2003.	HttpChannel HttpClientChannel
connectionTimeout	Entier qui spécifie la durée, en millisecondes, requise pour une connexion réussie. 0 ou -1 indiquent un délai d'attente infini. La valeur par défaut est Infinite.	IpcChannel IpcClientChannel
credentials	Objet qui implémente l'interface ICredentials qui représente l'identité du client.	HttpChannel HttpClientChannel
domain	Chaîne qui spécifie le nom de domaine à utiliser, conjointement avec le nom d'utilisateur spécifié par username et le mot de passe spécifié par password, lors de l'authentification auprès d'un canal serveur.	HttpClientChannel TcpClientChannel
password	Chaîne qui spécifie le mot de passe à utiliser, conjointement avec le nom d'utilisateur spécifié par username et le domaine spécifié par domain, lors de l'authentification auprès d'un canal serveur.	HttpClientChannel TcpClientChannel
proxyName	Chaîne qui spécifie le nom utilisé par le proxy lors des appels au serveur distant. Par défaut, le nom d'hôte de l'ordinateur client est utilisé.	HttpChannel HttpClientChannel
proxyPort	Entier qui spécifie le numéro de port à partir duquel le proxy effectue des appels au serveur distant. Par défaut, un port disponible et sans privilège est choisi à l'exécution.	HttpChannel HttpClientChannel
retryCount	Entier qui spécifie le nombre de fois que le client répète un appel distant qui a initialement échoué. La valeur par défaut est 1.	TcpClientChannel
servicePrincipleName	Chaîne qui spécifie le servicePrincipalName pour l'authentification Kerberos. La valeur par défaut est null.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
socketCachePolicy	Membre de l'énumération SocketCachePolicy qui spécifie si la durée indiquée par la propriété socketCacheTimeout est mesurée à partir du moment où un socket a été utilisé pour la dernière fois ou à partir du moment où un socket a été créé. La valeur par défaut est Default.	TcpClientChannel
socketCacheTimeout	Entier qui spécifie la durée, en secondes, après laquelle un socket est supprimé du cache maintenu par un objet TcpClientChannel. La valeur par défaut est cinq secondes.	TcpClientChannel
timeout	Entier qui spécifie la durée, en millisecondes, requise avant l'expiration d'une demande. 0 ou -1 indiquent un délai d'attente infini. La valeur par défaut est Infinite.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
tokenImpersonationLevel	Valeur de type TokenImpersonationLevel. Cette propriété spécifie la façon dont le client est authentifié auprès du serveur. Par défaut, sa valeur est None, sauf si la propriété secure a la valeur true, auquel cas la valeur par défaut est Identification.	TcpChannel TcpClientChannel
unsafeAuthenticatedConnectionSharing	Valeur Boolean qui indique si le partage de connexion authentifié NTLM à haut débit est autorisé. Si cette valeur est true, la valeur connectionGroupName doit correspondre à un seul utilisateur authentifié. Cette propriété est ignorée si useAuthenticatedConnectionSharing a la valeur true. Cette propriété est uniquement prise en charge par l version 1.1 et supérieure du .NET Framework sur les plateformes suivantes : Windows 98, Windows NT 4.0, Windows Millennium, Windows 2000, Windows XP Édition familiale, Windows XP Professionnel et Windows Server 2003.	HttpChannel HttpClientChannel
useAuthenticatedConnectionSharing	Valeur Boolean qui indique si le canal serveur réutilise des connexions authentifiées plutôt que d'authentifier chaque appel entrant. Par défaut, cette valeur est true si la propriété useDefaultCredentials a également la valeur true; sinon, la valeur est false, ce qui signifie que chaque appel est authentifié si le serveur requiert une authentification. Cela s'applique également à l'équivalent programmatique, qui est accompli soit en créant un objet qui implémente IDictionaryen définissant la propriété credentials à CredentialCache.DefaultCredentials, et en passant cette valeur au récepteur de canal, ou en utilisant l'IDictionary retourné par la méthode ChannelServices.GetChannelSinkProperties. Cette paire nom/valeur est uniquement prise en charge par la version 1.1 et supérieure du .NET Framework sur les plateformes suivantes : Windows 98, Windows NT 4.0, Windows Millennium, Windows 2000, Windows XP Édition familiale, Windows XP Professionnel et la famille Windows Server 2003.	HttpChannel HttpClientChannel
useDefaultCredentials	Valeur Boolean qui spécifie s'il faut présenter des informations d'identification pour l'identité associée au thread actuel lors de l'authentification auprès d'un canal serveur.	HttpChannel HttpClientChannel
username	Chaîne qui spécifie le nom d'utilisateur à utiliser, conjointement avec le mot de passe spécifié par password et le domaine spécifié par domain, lors de l'authentification auprès d'un canal serveur.	HttpClientChannel TcpClientChannel

Remarque :
Sous Windows 98 et Windows Millenium Edition, aucun ID de sécurité ne permet d'identifier le nom du groupe de connexions d'authentification. Par conséquent, un nom de groupe de connexions figure sur ces plateformes.

Remarque :

Si vous souhaitez que votre application passe l'implémentation ICredentials ou explicite les valeurs username, passwordet domain aux propriétés HttpClientChannel, vous pouvez activer le partage de connexion d'authentification en donnant à la propriété unsafeAuthenticatedConnectionSharing la valeur True et en définissant la propriété connectionGroupName, tout en vous en assurant que la valeur connectionGroupName ne correspond qu'à un seul utilisateur authentifié.

Voir aussi

Tâches

Comment : configurer un canal dans un fichier de configuration
Comment : configurer un canal par programme

Référence

Schéma des paramètres d'accès distant

Concepts

Configuration d'applications distantes
Configuration d'objets distants
Configuration d'objets distants

Copyright ©2007 par Microsoft Corporation. Tous droits réservés.