@ServiceHost
Associates the factory used to produce the service host with the service to be hosted and other programming aspects required to access or compile the hosting code provided in the .svc file.
Syntax
<% @ServiceHost
Service = "Service, ServiceNamespace"
Factory = "Factory, FactoryNamespace"
Debug = "Debug"
Language = "Language"
CodeBehind = "CodeBehind"
%>
Attributes
Service
The CLR type name of the service hosted. This should be a qualified name of a type that implements one or more of the service contracts.
Factory
The CLR type name of the service host factory used to instantiate the service host. This attribute is optional. If unspecified, the default ServiceHostFactory is used, which returns an instance of ServiceHost.
Debug
Indicates whether the Windows Communication Foundation (WCF) service should be compiled with debug symbols. true
if the WCF service should be compiled with debug symbols; otherwise, false
.
Language
Specifies the language used when compiling all the inline code within file (.svc). The values can represent any .NET-supported language, including C#
, VB
, and JS
, which refer to C#, Visual Basic, and JScript .NET, respectively. This attribute is optional.
CodeBehind
Specifies the source file that implements the XML Web service, when the class that implements the XML Web service does not reside in the same file and has not been compiled into an assembly and placed in the \Bin directory.
Remarks
The ServiceHost used to host the service is a point of extensibility within the Windows Communication Foundation (WCF) programming model. A factory pattern is used to instantiate the ServiceHost because it is, potentially, a polymorphic type that the hosting environment should not instantiate directly.
The default implementation uses ServiceHostFactory to create an instance of ServiceHost. But you can provide your own factory (one that returns your derived host) by specifying the CLR type name of your factory implementation in the @ServiceHost
directive.
To use you own custom service host factory instead of the default factory, just provide the type name in the @ServiceHost
directive as follows.
<% @ServiceHost Factory="DerivedFactory" Service="MyService" %>
Keep the factory implementations as light as possible. If you have lots of custom logic, your code is more reusable if you put that logic inside your host instead of inside the factory.
For example, to enable an AJAX-enabled endpoint for MyService
, specify the WebScriptServiceHostFactory for the value of the Factory
attribute, instead of the default ServiceHostFactory, in the @ServiceHost
directive as shown in the following example:
<% @ServiceHost
Service="MyService"
Language="C#"
Debug="true"
Factory="WebScriptServiceHostFactory"
%>