Proprietà del canale client

Nella tabella che segue sono indicate le proprietà del canale client che è possibile specificare.

Proprietà	Descrizione	Tipi che supportano questa proprietà
allowAutoRedirect	Valore booleano che indica se la gestione automatica dei reindirizzamenti server è attivata.	HttpChannel HttpClientChannel
clientConnectionLimit	Numero intero che indica quante connessioni possono essere aperte simultaneamente su un server specificato. Il valore predefinito è 2.	HttpChannel HttpClientChannel
connectionGroupName	Una stringa che specifica il nome che deve essere utilizzato come nome del gruppo di connessioni nel server se il valore unsafeAuthenticatedConnectionSharing è impostato su true. Questa proprietà viene ignorata se unsafeAuthenticatedConnectionSharing non è impostato su true. Se è specificato, verificare che questo nome sia mappato a un solo utente autenticato. Questa proprietà è supportata solo dalla versione 1.1 o superiore di .NET Framework sulle piattaforme seguenti: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional e famiglia Windows Server 2003.	HttpChannel HttpClientChannel
connectionTimeout	Numero intero che specifica il numero di millisecondi di attesa per una connessione. Un valore di 0 o -1 indica un periodo di timeout infinito. Il valore predefinito è Infinite.	IpcChannel IpcClientChannel
credentials	Un oggetto che implementa l'interfaccia ICredentials che rappresenta l'identità del client.	HttpChannel HttpClientChannel
domain	Una stringa che specifica un nome di dominio da utilizzare, insieme al nome utente specificato da username e alla password specificata da password in caso di autenticazione a un canale server.	HttpClientChannel TcpClientChannel
password	Una stringa che specifica la password da usare, insieme al nome utente specificato da username e al dominio specificato da domain in caso di autenticazione a un canale server.	HttpClientChannel TcpClientChannel
proxyName	Una stringa che specifica il nome utilizzatato dal proxy nell'effettuare chiamate al server remoto. Per impostazione predefinita, viene utilizzato il nome host del computer client.	HttpChannel HttpClientChannel
proxyPort	Numero intero che specifica il numero della porta dal quale il proxy effettua chiamate al server remoto. Per impostazione predefinita, a runtime viene scelta una porta disponibile, senza privilegi.	HttpChannel HttpClientChannel
retryCount	Numero intero che specifica per quante volte il client ripete una chiamata remota non andata a buon fine. Il valore predefinito è 1.	TcpClientChannel
servicePrincipalName	Una stringa che specifica il servicePrincipalName per l'autenticazione Kerberos. Il valore predefinito è null.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
socketCachePolicy	Un membro dell'enumerazione SocketCachePolicy che determina se il tempo specificato mediante la proprietà socketCacheTimeout viene misurato a partire dall'ora dell'ultimo utilizzo di un socket o dall'ora di creazione di un socket. Il valore predefinito è Default.	TcpClientChannel
socketCacheTimeout	Numero intero che specifica il tempo, in secondi dopo il quale un socket viene rimosso dalla cache gestita da un oggetto TcpClientChannel. Il valore predefinito è 5 secondi.	TcpClientChannel
timeout	Numero intero che specifica il numero di millisecondi di attesa prima che si verifichi il timeout di una richiesta. Un valore di 0 o -1 indica un periodo di timeout infinito. Il valore predefinito è Infinite.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
tokenImpersonationLevel	Valore di tipo TokenImpersonationLevel. Questa proprietà specifica come viene autenticato il client dal server. Il valore predefinito è None, a meno che la proprietà secure non sia impostata su true, caso in cui il valore predefinito è Identification.	TcpChannel TcpClientChannel
unsafeAuthenticatedConnectionSharing	Valore booleano che indica se consentire la condivisione di connessione con autenticazione NTLM ad alta velocità. Se questo valore è impostato su true, il valore connectionGroupName deve essere mappato su un unico utente autenticato. La proprietà viene ignorata se il valore useAuthenticatedConnectionSharing è impostato su true. Questa proprietà è supportata solo dalla versione 1.1 o superiore di .NET Framework sulle piattaforme seguenti: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional e famiglia Windows Server 2003.	HttpChannel HttpClientChannel
useAuthenticatedConnectionSharing	Un valore booleano che indica se il canale server riutilizza connessioni autenticate piuttosto che autenticare ogni chiamata in ingresso. Per impostazione predefinita, questo valore è impostato su true se anche il valore useDefaultCredentials è impostato su true; in caso contrario, il valore è impostato su false, ovvero ogni chiamata verrà autenticata se il server richiede l'autenticazione. Ciò si applica anche all'equivalente a livello di codice, realizzato creando un oggetto che implementa IDictionary, impostando la proprietà credentials su CredentialCache.DefaultCredentials e passando quel valore al sink di canale, o utilizzando l'IDictionary restituito dal metodo ChannelServices.GetChannelSinkProperties. Questa coppia nome/valore è supportata solo dalla versione 1.1 o superiore di .NET Framework sulle piattaforme seguenti: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional e Windows Server 2003.	HttpChannel HttpClientChannel
useDefaultCredentials	Un valore booleano che specifica se presentare o meno credenziali per l'identità associa al thread corrente in caso di autenticazione a un canale server.	HttpChannel HttpClientChannel
username	Una stringa che specifica il nome utente da usare, insieme alla password specificata da password e al dominio specificato da domain in caso di autenticazione a un canale server.	HttpClientChannel TcpClientChannel

Nota:
Su Windows 98 e Windows Me, non è nessun ID di sicurezza (SID) per identificare il nome del gruppo di connessione di autenticazione. Su queste piattaforme, pertanto, c'è un nome del gruppo di connessione.

Nota:

Se si vuole che l'applicazione passi l'implementazione ICredentials o gli espliciti valori username, password e domain nelle proprietà HttpClientChannel, sarà possibile abilitare la condivisione di connessione di autenticazione impostando la proprietà unsafeAuthenticatedConnectionSharing su true e impostando la proprietà connectionGroupName, assicurandosi che il valore connectionGroupName venga mappato su un solo utente autenticato.

Vedere anche

Attività

Procedura: Configurare un canale in un file di configurazione
Procedura: Configurare un canale a livello di programmazione

Riferimenti

Schema delle impostazioni remote

Concetti

Configurazione di applicazioni remote
Configurazione di oggetti remoti
Configurazione di oggetti remoti

Copyright © 2007 Microsoft Corporation. Tutti i diritti riservati.