Freigeben über

<channel>-Element (Instanz)

  • Artikel

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>-Element

    <application>-Element

      <channels>-Element (Instanz)

        <channel>-Element (Instanz)

<!-- 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"
/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete sowie übergeordnete Elemente beschrieben.

Attribute

Attribut Beschreibung

ref

Optionales Attribut.

Gibt die id der Channelvorlage an, die der Client für die Verwendung registrieren möchte. Wenn Sie ein ref-Attribut angeben, müssen Sie kein type-Attribut festlegen.

.NET Framework-Remoting stellt drei Channelimplementierungen bereit: "http", "tcp" und "ipc". Weitere Informationen über das Auswählen einer Channelimplementierung finden Sie unter Auswählen eines Channels.

displayName

Optionales Attribut.

Wird vom .NET Framework-Konfigurationstool zum Erstellen einer Liste von Channels verwendet, die von dieser Anwendung registriert wurden. Dieses Attribut wird vom .NET Framework-Remotesystem nicht verwendet.

type

Optionales Attribut.

Gibt den vollständigen Typnamen des Channels und den Namen der Assembly an, in der sich die Channelimplementierung befindet. Hierzu gehören 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.

.NET Framework-Remoting stellt drei Channelimplementierungen bereit: "http", "tcp" und "ipc". Weitere Informationen über das Auswählen einer Channelimplementierung finden Sie unter Auswählen eines Channels.

port

Optionales Attribut.

Gibt ein geeignetes Anschlussattribut an. Sie können hier z. B. ein Anschlussattribut angeben, wenn der Channel einen Anschluss überwachen soll. Manche Channels, z. B. TcpChannel, erfordern eine Anschlussspezifikation. Andere Channels, z. B. 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 Framework-Remotesystem einen geeigneten Anschluss aus. Wenn Sie keinen Anschluss für einen Clientchannel angeben, kann der Client keine Rückruffunktionen aus dem Remoteobjekt erhalten.

portName

Erforderliches Attribut für IpcChannel oder IpcServerChannel. Gibt den Namen des Anschlusses an, den der Server verfügbar macht.

<customChannelProperty>

Optionales Attribut.

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" 
/>

useIpAddress

Ein boolescher Wert (true oder false), der angibt, ob in der Veröffentlichungs-URL anstelle des Computernamens die IP-Adresse verwendet werden soll. In drahtlosen Netzwerken wird z. B. häufig die IP-Adresse eines tragbaren Computers bei Positionsänderungen innerhalb des Netzwerks geändert. Wenn Sie für diesen Wert false festlegen, wird anstelle der Adresse der Computername verwendet, sodass Remoteverbindungen beim Roaming nicht getrennt werden. Der Standardwert ist true. Dieser Wert kann durch die machineName-Eigenschaft überschrieben werden, wenn diese Eigenschaft mit einem Serverchannel verwendet wird.

machineName

Eine Zeichenfolge, die den für diesen Channel verwendeten Computernamen angibt. In Verbindung mit einem Serverchannel überschreibt sie useIpAddress.

Hinweis   Es empfiehlt sich generell, den DNS-Namen (Domain Name System) des Computers zu verwenden. Wenn jedoch die IP-Adresse für eine bestimmte NIC (Network Interface Card, Netzwerkschnittstellenkarte) häufig geändert wird, wobei es sich in der Regel um eine drahtlose NIC handelt, müssen Sie die Anwendung so konfigurieren, dass machineName verwendet wird und Remoting den Computer über DNS finden kann. Wenn der Computername nur äußerst langsam bzw. überhaupt nicht aufgelöst wird und der Computer über mehrere physische oder virtuelle NICs verfügt (dies ist häufig der Fall bei DFÜ-Verbindungen oder VPN-Netzwerkkarten), sollten Sie für die machineName-Eigenschaft die IP-Adresse der NIC festlegen, die derzeit für diese Verbindung verwendet wird.

Untergeordnete Elemente

Element Beschreibung

<serverProviders>

Enthält Empfängeranbieter 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ängeranbieter 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.

Übergeordnete Elemente

Element Beschreibung

application

Enthält Informationen über Remoteobjekte, die von der Anwendung verwendet und verfügbar gemacht werden.

channels

Enthält Channels, über die die Anwendung mit Remoteobjekten kommuniziert. Dieses Element konfiguriert Channelvorlagen oder deklariert neue Channels für die Verwendung in der angegebenen Anwendung.

configuration

Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

system.runtime.remoting

Enthält Informationen über Remoteobjekte und Channels.

Hinweise

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

Beispiel

Die folgende Konfigurationsdatei deklariert den Speicherort eines Remotetyps für eine Clientanwendung und weist das .NET Framework-Remotesystem mithilfe des <channels>-Instanzelements an, einen geeigneten Anschluss für die Verbindung zum Serverobjekt zu suchen 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>

Siehe auch

Referenz

Schema für Remoteeinstellungen
HttpChannel
HttpClientChannel
HttpServerChannel
TcpChannel
TcpClientChannel
TcpServerChannel
IpcChannel
IpcClientChannel
IpcServerChannel

Footer image

Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.