<wellknown>-Element (Dienstinstanz)

  • Artikel

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 zu den vom Server aktivierten (bekannten) Objekte, die die Anwendung den Clients verfügbar macht. Dieses Element kann in einer Anwendungskonfigurationsdatei oder einer Computerkonfigurationsdatei verwendet werden.

Schema Hierarchy

<configuration>
  <system.runtime.remoting>-Element
    <application>-Element
      <service>-Element
        <wellknown>-Element (Dienstinstanz)

Syntax

<wellknown  
   mode="Singleton|SingleCall"
   displayName="name"
   type="type,assembly" 
      objectUri="objectUri" 
/>

Attribute und Elemente

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

Attribute

Attribut Beschreibung

mode

Erforderliches Attribut

Gibt an, ob es sich bei dem Objekt um ein Singleton- oder ein SingleCall-Objekt handelt. Eine der beiden Optionen muss gewählt werden. Weitere Informationen hierzu finden Sie unter Aktivierung.

objectUrl

Erforderliches Attribut

Gibt den Endpunkt des URIs (Uniform Resource Identifier) des Objekts an.

type

Erforderliches Attribut

Gibt den vollständigen Typnamen des Objekts und den Assemblynamen der Typimplementierung an. Hierzu gehören die Version, die Kultur und der öffentliche Schlüssel, wenn die übergeordnete Assembly sich im globalen Assemblycache befindet.

displayName

Optionales Attribut.

Wird vom .NET Framework-Konfigurationstool zum Erstellen einer Liste von serveraktivierten Objekten verwendet, für deren Veröffentlichung dieser Server 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.

configuration

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

service

Enthält Objekte, die die Anwendung in anderen Anwendungsdomänen oder Kontexten verfügbar macht.

system.runtime.remoting

Enthält Informationen über Remoteobjekte und Channels.

Hinweise

Wenn Internetinformationsdienste (IIS) als Host für ein Objekt fungieren, muss die objectUri-Erweiterung .soap oder .rem lauten, damit die Anforderung an den IHttpHandler von .NET Framework-Remoting weitergeleitet wird.

Beispiel

In der folgenden Konfigurationsdatei werden ein vom Server aktivierter (bekannter) Typ, der Objekt-URI, unter dem sich dieser befindet, sowie der WellKnownObjectMode deklariert, der die Aktivierung von Instanzen steuert.

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
            <wellknown 
               type="ServerActivatedType, RemoteAssembly" 
               objectUri="ServerType.rem" 
               mode="Singleton" 
            />
         </service>
      </application>
   </system.runtime.remoting>
</configuration>

Siehe auch

Verweis

Schema für Remoteeinstellungen

Konzepte

Aktivierung von Remoteobjekten
Konfiguration von Remoteanwendungen

Erstellungsdatum: 2010-02-13