Eigenschaften für Clientchannels

Die folgende Tabelle zeigt die Eigenschaften für Clientchannels, die angegeben werden können.

Eigenschaft	Beschreibung	Typen, die diese Eigenschaft unterstützen
allowAutoRedirect	Ein boolescher Wert, der angibt, ob die automatische Behandlung von Serverumleitungen aktiviert ist.	HttpChannel HttpClientChannel
clientConnectionLimit	Eine ganze Zahl, die die Anzahl der Verbindungen angibt, die für einen bestimmten Server gleichzeitig geöffnet werden können. Der Standardwert ist 2.	HttpChannel HttpClientChannel
connectionGroupName	Eine Zeichenfolge, die den Namen angibt, der auf dem Server als Verbindungsgruppenname verwendet werden soll, wenn der unsafeAuthenticatedConnectionSharing-Wert auf true festgelegt ist. Diese Eigenschaft wird ignoriert, wenn unsafeAuthenticatedConnectionSharing nicht auf true festgelegt ist. Wenn angegeben, müssen Sie sicherstellen, dass dieser Name nur einem authentifizierten Benutzer zuordnet wird. Diese Eigenschaft wird nur von .NET Framework, Version 1.1 oder höher, für die folgenden Plattformen unterstützt: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional und die Windows Server 2003-Familie.	HttpChannel HttpClientChannel
connectionTimeout	Eine ganze Zahl, die die Anzahl Millisekunden angibt, die auf eine erfolgreiche Verbindung gewartet werden soll. 0 oder -1 gibt ein unendliches Timeout an. Die Standardeinstellung ist Infinite.	IpcChannel IpcClientChannel
credentials	Ein Objekt, das die ICredentials-Schnittstelle implementiert, die die Identität des Clients darstellt.	HttpChannel HttpClientChannel
domain	Eine Zeichenfolge, die einen zu verwendenden Domänennamen in Verbindung mit dem durch username festgelegten Benutzernamen und dem durch password festgelegten Kennwort angibt, wenn eine Authentifizierung an einem Serverchannel erfolgt.	HttpClientChannel TcpClientChannel
password	Eine Zeichenfolge, die ein zu verwendendes Kennwort in Verbindung mit dem durch username festgelegten Benutzernamen und der durch domain festgelegten Domäne angibt, wenn eine Authentifizierung an einem Serverchannel erfolgt.	HttpClientChannel TcpClientChannel
proxyName	Eine Zeichenfolge, die den vom Proxy verwendeten Namen angibt, wenn Aufrufe für den Remoteserver ausgeführt werden. Standardmäßig wird der Hostname des Clientcomputers verwendet.	HttpChannel HttpClientChannel
proxyPort	Eine ganze Zahl, die die Anschlussnummer angibt, von der aus der Proxy Aufrufe für den Remoteserver ausführt. Standardmäßig wird zur Laufzeit ein verfügbarer, nicht privilegierter Anschluss ausgewählt.	HttpChannel HttpClientChannel
retryCount	Eine ganze Zahl, die angibt, wie oft der Client einen anfänglich fehlgeschlagenen Remoteaufrufversuch wiederholt. Der Standardwert ist 1.	TcpClientChannel
servicePrincipleName	Eine Zeichenfolge, die servicePrincipalName zur Kerberos-Authentifizierung angibt. Der Standardwert ist null.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
socketCachePolicy	Ein Member der SocketCachePolicy-Enumeration, die angibt, ob die von der socketCacheTimeout-Eigenschaft angegebene Zeit vom Zeitpunkt der letzten Verwendung oder dem Erstellungszeitpunkt eines Sockets gemessen werden soll. Die Standardeinstellung ist Default.	TcpClientChannel
socketCacheTimeout	Eine ganze Zahl, die die Zeit in Sekunden angibt, nach der ein Socket aus dem von einem TcpClientChannel-Objekt verwalteten Cache entfernt wird. Der Standardwert beträgt fünf Sekunden.	TcpClientChannel
timeout	Eine ganze Zahl, die die Wartezeit in Millisekunden bis zum Timeout einer Anforderung angibt. 0 oder -1 gibt ein unendliches Timeout an. Die Standardeinstellung ist Infinite.	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
tokenImpersonationLevel	Ein Wert vom Typ TokenImpersonationLevel. Diese Eigenschaft gibt an, wie der Client beim Server authentifiziert wird. Die Standardeinstellung ist None, es sei denn, die secure-Eigenschaft ist auf true festgelegt ist. In diesem Fall ist die Standardeinstellung Identification.	TcpChannel TcpClientChannel
unsafeAuthenticatedConnectionSharing	Ein boolescher Wert, der angibt, ob die Freigabe NTLM-authentifizierter Hochgeschwindigkeitsverbindungen zulässig ist. Wenn dieser Wert auf true festgelegt ist, darf der connectionGroupName-Wert nur einem authentifizierten Benutzer zugeordnet werden. Diese Eigenschaft wird ignoriert, wenn der useAuthenticatedConnectionSharing-Wert auf true festgelegt ist. Diese Eigenschaft wird nur von .NET Framework, Version 1.1 oder höher, für die folgenden Plattformen unterstützt: Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional und Windows Server 2003.	HttpChannel HttpClientChannel
useAuthenticatedConnectionSharing	Ein boolescher Wert, der angibt, ob der Serverchannel authentifizierte Verbindungen wiederverwendet, anstatt jeden eingehenden Aufruf zu authentifizieren. Standardmäßig ist dieser Wert auf true festgelegt, wenn der useDefaultCredentials-Wert ebenfalls auf true festgelegt ist; ansonsten wird der Wert auf false festgelegt. Dies bedeutet, dass jeder Aufruf authentifiziert wird, wenn der Server eine Authentifizierung erfordert. Dies gilt auch für die programmgesteuerte Entsprechung. Diese wird entweder durch Erstellen eines Objekts, das IDictionary implementiert, Einstellen der credentials-Eigenschaft auf CredentialCache.DefaultCredentials und Übergeben des Werts an den Channelempfänger oder durch Verwenden von IDictionary erreicht, das von der ChannelServices.GetChannelSinkProperties-Methode zurückgegeben wird. Dieses Name-Wert-Paar wird nur von .NET Framework, Version 1.1 oder höher, für die folgenden Plattformen unterstützt: Microsoft Windows 98, Windows NT 4.0, Windows Millenium Edition (Windows Me), Windows 2000, Windows XP Home Edition, Windows XP Professional und Windows Server 2003.	HttpChannel HttpClientChannel
useDefaultCredentials	Ein boolescher Wert, der festlegt, ob die Anmeldeinformationen für die Identität, die dem aktuellen Thread zugewiesen ist, bei der Authentifizierung an einem Serverchannel angegeben werden müssen.	HttpChannel HttpClientChannel
username	Eine Zeichenfolge, die einen zu verwendenden Benutzernamen in Verbindung mit dem durch password festgelegten Kennwort und der durch domain festgelegten Domäne angibt, wenn eine Authentifizierung an einem Serverchannel erfolgt.	HttpClientChannel TcpClientChannel

Hinweis:
Unter Windows 98 und Windows Me, gibt es keine Sicherheits-ID, um den Verbindungsgruppennamen für die Authentifizierung zu kennzeichnen. Deshalb gibt es auf diesen Plattformen einen Verbindungsgruppennamen.

Hinweis:

Wenn die Anwendung die ICredentials-Implementierung oder die expliziten Werte username, password und domain in den HttpClientChannel-Eigenschaften übergeben soll, können Sie die Freigabe der Authenifizierungsverbindung aktivieren. Legen Sie dazu außerdem die unsafeAuthenticatedConnectionSharing-Eigenschaft auf true sowie die connectionGroupName-Eigenschaft fest, und stellen Sie sicher, dass der connectionGroupName-Wert nur einem authentifizierten Benutzer zugeordnet wird.

Siehe auch

Aufgaben

Gewusst wie: Konfigurieren eines Channels in einer Konfigurationsdatei
Gewusst wie: Programmgesteuertes Konfigurieren eines Channels

Referenz

Schema für Remoteeinstellungen

Konzepte

Konfiguration von Remoteanwendungen
Remoteobjektkonfiguration
Remoteobjektkonfiguration

Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.