<wellknown>-Element (Clientinstanz)

Dieses Thema bezieht sich auf eine veraltete Technologie, die zum Zwecke der Abwärtskompatibilität mit vorhandenen Anwendungen beibehalten wird und nicht für die neue Entwicklung empfohlen wird. Verteilte Anwendungen sollten jetzt mit  Windows Communication Foundation (WCF) entwickelt werden.

Enthält Informationen über vom Server aktivierte (bekannte) Objekte, die von der Anwendung verwendet werden sollen. Wenn ein Client ein <wellknown>-Element verwendet, benötigt das übergeordnete <client>-Element kein url-Attribut. Dieses Element kann in einer Anwendungskonfigurationsdatei oder einer Computerkonfigurationsdatei verwendet werden.

Schema Hierarchy

<configuration>
  <system.runtime.remoting>-Element
    <application>-Element
      <client>-Element
        <wellknown>-Element (Clientinstanz)

Syntax

<wellknown  
   url="url" 
   displayName="displayName" 
   type="type,assembly"
/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
type	Erforderliches Attribut Gibt den vollständigen Typnamen des Objekts und den Assemblynamen der Typimplementierung auf dem Client an. Hierzu gehören die Version, die Kultur und der öffentliche Schlüssel, wenn die übergeordnete Assembly sich im globalen Assemblycache befindet.
url	Erforderliches Attribut Gibt die vollständige URL des vom Server aktivierten Typs an, einschließlich des Objekt-URIs (Uniform Resource Identifier).
displayName	Optionales Attribut. Wird vom .NET Framework-Konfigurationstool zum Erstellen einer Liste von serveraktivierten Objekten verwendet, für deren Aufruf dieser Client registriert ist. Das .NET Framework-Remotingsystem verwendet dieses Attribut nicht.

Untergeordnete Elemente

Keines.

Übergeordnete Elemente

Element	Beschreibung
application	Enthält Informationen über Remoteobjekte, die die Anwendung verwendet und verfügbar macht.
client	Enthält Objekte, die die Anwendung verwendet. Da das url-Attribut für clientaktivierte Typen, jedoch nicht für serveraktivierte Typen benötigt wird, verfügt jede eindeutige URL über ein eigenes client-Element, das die an diesem Speicherort veröffentlichten clientaktivierten Typen enthält.
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 zu Remoteobjekten und Channels.

Beispiel

In der folgenden Konfigurationsdatei wird ein vom Server aktivierter (bekannter) Remotetyp für die Verwendung deklariert und angegeben, dass die Clientanwendung HttpChannel verwenden soll. Darüber hinaus wird festgelegt, dass das .NET Framework-Remotesystem berechtigt sein soll, im Auftrag des Clients einen geeigneten Anschluss zu suchen.

<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

Verweis

Schema für Remoteeinstellungen

Konzepte

Aktivierung von Remoteobjekten

Erstellungsdatum: 2010-02-13