Konfigurationseigenschaften für Channel und Formatierungsprogramme

In diesem Thema werden alle Konfigurationseigenschaften aufgelistet und erläutert, die Sie für die IChannel-Implementierungen im .NET Remoting-System festlegen können. Alle Werte werden bei Deklaration in der Konfigurationsdatei als Zeichenfolgen dargestellt Wenn Sie aber die IDictionary-Eigenschaft programmgesteuert erstellen, können ganzzahlige Werte als ganze Zahlen (ohne Anführungszeichen) oder als Zeichenfolgen (Werte in Anführungszeichen) und boolesche Werte als Boolean festgelegt werden. Alle anderen Werte werden als Zeichenfolgen festgelegt. Im folgenden Codebeispiel wird veranschaulicht, wie die Werte in einer Konfigurationsdatei eines <channel>-Elements angezeigt werden könnten. (Wenn Sie eine Vorlage bestimmen möchten, die einen im globalen Assemblycache enthaltenen Typ verwendet, müssen Sie darauf achten, zur Bindung an den richtigen Typ alle Versionsinformationen und Informationen über starke Namen hinzuzufügen.)

<channel 
   name="MyCustomChannel"  
   priority="2"
   type="CustomChannelName, CustomAssembly, Version=1.0.6940.0, Culture=neutral, PublicKeyToken=somepublickeystring" 
/>

Im folgenden Codebeispiel wird gezeigt, wie die Werte erscheinen könnten, wenn Sie dies programmgesteuert für eine Serveranwendungsdomäne festlegten. In diesem Fall gibt der Server an, dass das Remotingsystem ein HttpChannel-Objekt für die Übertragung, jedoch ein BinaryFormatter-Objekt für Serialisierung und Deserialisierung verwendet.

Dim props = New Hashtable() As IDictionary
props("name") = "ChannelName1" 
Dim channel As New HttpChannel( _
   props, _
   Nothing, _
   New BinaryServerFormatterSinkProvider() _
)
ChannelServices.RegisterChannel(channel)

[C#]
IDictionary props = new Hashtable();
props["name"] = "MyHttpChannel";
HttpChannel channel = new HttpChannel(
   props, 
   null, 
   new BinaryServerFormatterSinkProvider()
);
ChannelServices.RegisterChannel(channel);

In der folgenden Tabelle werden die allgemeinen Channeleigenschaften aufgeführt, die angegeben werden können.

In der folgenden Tabelle werden die Clientchanneleigenschaften aufgeführt, die angegeben werden können.

Hinweis   Unter Windows 98 und Windows Me ist keine Sicherheits-ID verfügbar, mit der der Name der Verbindungsgruppe bei der Authentifizierung identifiziert werden kann. Aus diesem Grund ist auf diesen Plattformen nur ein Verbindungsgruppenname verfügbar.

Wenn die Anwendung die ICredentials-Implementierung bzw. explizite Werte für username, password und domain an die HttpClientChannel-Eigenschaften übergeben soll, können Sie die Freigabe von Verbindungen bei der Authentifizierung aktivieren, indem Sie das Name/Wert-Paar für unsafeAuthenticatedConnectionSharing und das Name/Wert-Paar für connectionGroupName ebenfalls übergeben, wobei der Wert von connectionGroupName nur einem authentifizierten Benutzer zugeordnet sein darf.

In der folgenden Tabelle werden die Serverchanneleigenschaften aufgeführt, die angegeben werden können.

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die für Channelempfänger angegeben werden können.

Siehe auch

Konfiguration | Remoteobjektkonfiguration | Schema für Remoteeinstellungen