Konfigurationsbasierte Aktivierung unter IIS und WASConfiguration-Based Activation in IIS and WAS

Wenn Sie einen Windows Communication Foundation (WCF)-Dienst unter Internetinformationsdienste (Internet Information Services, IIS) oder Windows Process Activation Service (WAS) hosten, müssen Sie normalerweise eine SVC-Datei angeben.Normally when hosting a Windows Communication Foundation (WCF) service under Internet Information Services (IIS) or Windows Process Activation Service (WAS), you must provide a .svc file. Die SVC-Datei enthält den Namen des Diensts und eine optionale benutzerdefinierte Diensthostfactory.The .svc file contains the name of the service and an optional custom service host factory. Diese Zusatzdatei verursacht einen höheren Verwaltungsmehraufwand.This additional file adds manageability overhead. Die konfigurationsbasierte Aktivierungsfunktion entfernt die Anforderung einer SVC-Datei, sodass auch der damit verbundene Mehraufwand entfällt.The configuration-based activation feature removes the requirement to have a .svc file and therefore the associated overhead.

Konfigurationsbasierte AktivierungConfiguration-Based Activation

Die konfigurationsbasierte Aktivierung fügt die Metadaten, die zuvor in die SVC-Datei eingefügt wurden, in die Datei "Web.config" ein.Configuration-based activation takes the metadata that used to be placed in the .svc file and places it in the Web.config file. In der <serviceHostingEnvironment> Element besteht eine <serviceActivations> Element.Within the<serviceHostingEnvironment> element there is a <serviceActivations> element. In der <serviceActivations>-Element sind eine oder mehrere <add> Elemente, jeweils eines für jeden gehosteten Dienst.Within the <serviceActivations> element are one or more <add> elements, one for each hosted service. Die <add>-Element enthält Attribute, mit denen Sie die relative Adresse für den Dienst und den Typ oder einer Diensthostfactory festlegen können.The <add> element contains attributes that let you set the relative address for the service and the service type or a service host factory. Der folgende Konfigurationsbeispielcode zeigt, wie dieser Abschnitt verwendet wird.The following configuration example code shows how this section is used.

Hinweis

Jedes <add>-Element muss einen Dienst oder ein factoryattribut angeben.Each <add> element must specify a service or a factory attribute. Es kann auch einen Dienst und Factoryattribute angeben.Specifying both service and factory attributes is allowed.

<serviceHostingEnvironment>  
  <serviceActivations>  
    <add relativeAddress="MyServiceAddress" service="Service" factory="MyServiceHostFactory"/>  
  </serviceActivations>  
</serviceHostingEnvironment>  

Wenn dieser Code in der Datei Web.config enthalten ist, können Sie den Dienstquellcode in das Verzeichnis App_Code der Anwendung oder eine kompilierte Assembly im Verzeichnis Bin der Anwendung einfügen.With this in the Web.config file, you can place the service source code in the App_Code directory of the application or a complied assembly in the Bin directory of the application.

Hinweis

  • Bei Verwendung der konfigurationsbasierten Aktivierung wird Inlinecode in SVC-Dateien nicht unterstützt.When using configuration-based activation, inline code in .svc files is not supported.
    • Die relativeAddress Attribut muss festgelegt werden, um eine relative Adresse wie z. B. "<Unterverzeichnis > / service.svc" oder "~ /<Unterverzeichnis/service.svc".The relativeAddress attribute must be set to a relative address such as "<sub-directory>/service.svc" or "~/<sub-directory/service.svc".
    • Es wird eine Konfigurationsausnahme ausgelöst, wenn Sie eine relative Adresse registrieren, für die keine bekannte Erweiterung mit WCF-Zuordnung vorhanden ist.A configuration exception is thrown if you register a relative address that does not have a known extension associated with WCF.
    • Die angegebene relative Adresse ist relativ zum Stamm der virtuellen Anwendung.The relative address specified is relative to the root of the virtual application.
    • Aufgrund des hierarchischen Konfigurationsmodells werden die registrierten relativen Adressen auf Computer- und Siteebene von den virtuellen Anwendungen geerbt.Due to the hierarchical model of configuration, the registered relative addresses at machine and site level are inherited by virtual applications.
    • Registrierungen in einer Konfigurationsdatei haben Vorrang vor Einstellungen in einer SVC-, XAMLX-, XOML- oder anderen Datei.Registrations in a configuration file take precedence over settings in a .svc, .xamlx, .xoml, or other file.
    • Alle umgekehrten Schrägstriche ('') in einem URI, der an IIS/WAS gesendet wird, werden automatisch in einen normalen Schrägstrich ('/') konvertiert.Any ‘\’ (backslashes) in a URI sent to IIS/WAS are automatically converted to a ‘/’ (forward slash). Wenn eine relative Adresse hinzugefügt wird, die '' enthält, und Sie einen URI an IIS senden, für den die relative Adresse verwendet wird, wird der umgekehrte Schrägstrich in einen Schrägstrich konvertiert, und IIS kann keine Übereinstimmung mit der relativen Adresse herstellen.If a relative address is added that contains a ‘\’ and you send IIS a URI that uses the relative address, the backslash is converted to a forward slash and IIS cannot match it to the relative address. IIS sendet Ablaufverfolgungsinformationen, die angeben, dass keine Übereinstimmungen gefunden wurden.IIS sends out trace information that indicates that there are no matches found.

Siehe auchSee Also

ServiceActivations
Hosting-DiensteHosting Services
Übersicht über das Hosten von WorkflowdienstenHosting Workflow Services Overview
<ServiceHostingEnvironment ><serviceHostingEnvironment>
Windows Server AppFabric-HostingfunktionenWindows Server App Fabric Hosting Features