<channel>-Element (Instanz)

Artikel
03/31/2008

Konfiguriert den Channel, über den die Anwendung mit Remoteobjekten kommuniziert. Sie können auch einen neuen Channel deklarieren und konfigurieren, der keine Channelvorlage ist.

<configuration>
   <system.runtime.remoting>
      <application>
         <channels>
            <channel>

<!-- Either reference a channel template -->
<channel 
   ref="channelRef"    displayName="name"   port="port"/><!-- Or declare a particular channel instance --><channel    type="ChannelType, ChannelAssembly"   displayName="name"   port="port"   customChannelProperty="propertyValue"/>

Optionale Attribute

Attribut	Beschreibung
ref	Gibt die id der Channelvorlage an, die der Client für die Verwendung registrieren wird. Wenn Sie ein ref-Attribut angeben, müssen Sie kein type-Attribut festlegen.
displayName	Wird vom .NET Framework-Konfigurationstool zum Erstellen einer Liste von Channels verwendet, die in dieser Anwendung registriert sind. Das .NET Remoting-System verwendet dieses Attribut nicht.
type	Gibt den vollständigen Typnamen des Channels und den Namen der Assembly an, in der sich die Channelimplementierung befindet. Hierzu gehört die Version, die Kultur und der öffentliche Schlüssel, wenn die übergeordnete Assembly sich im globalen Assemblycache befindet. Dieses Attribut ist erforderlich, wenn Sie kein ref-Attribut verwenden.
port	Gibt ein geeignetes Anschlussattribut an. Sie können hier z. B. ein Anschlussattribut angeben, wenn der Channel einen Anschluss überwachen soll. Bestimmte Channels, z. B. der TcpChannel, erfordern eine Anschlussspezifikation. Andere Channels, z. B. der HttpChannel, haben Standardanschlüsse, daher muss dieses Attribut für diese Channels nicht vorhanden sein. Wenn Sie einen Client erstellen und 0 (null) als Anschluss angeben, wählt das .NET Remoting-System einen geeigneten Anschluss aus. Wenn Sie keinen Anschluss für einen Clientchannel angeben, kann der Client keine Rückruffunktionen aus dem Remoteobjekt erhalten.
<customChannelProperty>	Gibt eine Eigenschaft für einen unterstützten benutzerdefinierten Channel an. Sie können eine beliebige Anzahl an Channeleigenschaften angeben, die von Channels unterstützt werden können. Eine benutzerdefinierte Channeleigenschaft geben Sie mit einem Attribut-Wert-Paar an. Beispiel: `<channel ref="CustomChannel" port="61000" customProperty="PropertyValue" />`

Untergeordnete Elemente

Element	Beschreibung
<serverProviders>	Enthält Empfängerprovider für Empfänger, die in die serverseitige Channelempfänger-Aufrufkette eingefügt werden sollen. Werden diese angegeben, überschreiben sie die Standardeinstellungen für den Channel vollständig Kann im <channel>-Element einmal vorkommen.
<clientProviders>	Enthält Empfängerprovider für Empfänger, die in die clientseitige Channelempfänger-Aufrufkette eingefügt werden sollen. Werden diese angegeben, überschreiben sie die Standardeinstellungen für den Channel vollständig Kann im <channel>-Element einmal vorkommen.

Hinweise

Der vom System bereitgestellte HttpChannel und TcpChannel wird jeweils in der Konfigurationsdatei für den Computer gespeichert. Die id-Attribute dieser Channels lauten "http" bzw. "tcp".

Beispiel

Die folgende Konfigurationsdatei deklariert den Speicherort eines Remotetyps für eine Clientanwendung und weist mit Hilfe des <channels>-Instanzelements das .NET Remoting-System an, einen geeigneten Anschluss für die Verbindung zum Serverobjekt zu finden und den Standard-HttpChannel zu verwenden.

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown 
               type="RemoteType, RemoteAssembly"
               url="http://computername:8080/RemoteType.rem"
            />
         </client>
         <channels>
            <channel 
               ref="http" 
               port="0"
            />
         </channels>
      </application>
   </system.runtime.remoting>
</configuration>

Anforderungen

Konfigurationsdateien: Anwendungskonfigurationsdatei, Konfigurationsdatei für den Computer (Machine.config)

Siehe auch

Freigeben über