<add> von <serviceActivations>
Ein Konfigurationselement, das Ihnen ermöglicht, virtuelle Dienstaktivierungseinstellungen zu definieren, die Ihren WCF-Diensttypen (Windows Communication Foundation) entsprechen. Auf diese Weise können Sie in WAS/IIS gehostete Dienste ohne eine SVC-Datei aktivieren.
<configuration>
<system.serviceModel>
<serviceHostingEnvironment>
<serviceActivations>
<add>
Syntax
<serviceHostingEnvironment>
<serviceActivations>
<add factory="String"
service="String" />
</serviceActivations>
</serviceHostingEnvironment>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
attribute | BESCHREIBUNG |
---|---|
Fabrik | Eine Zeichenfolge, die den CLR-Typnamen der Factory angibt, die ein Dienstaktivierungselement generiert. |
Dienst | Der ServiceType, der den Dienst implementiert (entweder der vollqualifizierte Typname oder der kurze Typname, falls im Ordner "App_Code" enthalten). |
relativeAddress | Die relative Adresse innerhalb der aktuellen IIS-Anwendung, z. B. "Service.svc". In WCF 4.0 muss diese relative Adresse eine der bekannten Dateierweiterungen (.svc, .xamlx usw.) enthalten. Für relativeUrl muss keine physische Datei vorhanden sein. |
Untergeordnete Elemente
Keine
Übergeordnete Elemente
Element | BESCHREIBUNG |
---|---|
<serviceHostingEnvironment> | Ein Konfigurationsabschnitt, der Aktivierungseinstellungen beschreibt. |
Bemerkungen
Im folgenden Beispiel wird gezeigt, wie Aktivierungseinstellungen innerhalb der Datei web.config konfiguriert werden.
<configuration>
<system.serviceModel>
<serviceHostingEnvironment>
<serviceActivations>
<add service="GreetingService" />
</serviceActivations>
</serviceHostingEnvironment>
</system.serviceModel>
</configuration>
Mit dieser Konfiguration können Sie das GreetingService-Element aktivieren, ohne eine SVC-Datei zu verwenden.
Beachten Sie, dass es sich bei <serviceHostingEnvironment>
um eine Konfiguration auf Anwendungsebene handelt. Sie müssen das web.config
-Element, das die Konfiguration enthält, unter dem Stammelement der virtuellen Anwendung platzieren. Außerdem ist serviceHostingEnvironment
ein vererbbarer Abschnitt machineToApplication. Wenn Sie einen einzelnen Dienst im Stammelement des Computers registrieren, erbt jeder Dienst in der Anwendung diesen Dienst.
Die konfigurationsbasierte Aktivierung unterstützt sowohl die Aktivierung über http als auch über ein anderes Protokoll. Sie erfordert Erweiterungen im relativeAddress-Element, z. B. .svc, .xoml oder .xamlx. Sie können den bekannten buildProviders eigene Erweiterungen zuordnen, die Ihnen dann ermöglichen, den Dienst über eine beliebige Erweiterung zu aktivieren. Bei einem Konflikt überschreibt der Abschnitt <serviceActivations>
die SVC-Registrierungen.