WebScriptServiceHostFactory Class

WebScriptServiceHostFactory Class

.NET Framework (current version)
 

Automatically adds an ASP.NET AJAX endpoint to a service, without requiring configuration, in a managed hosting environment that dynamically activates host instances for the service in response to incoming messages.

Namespace:   System.ServiceModel.Activation
Assembly:  System.ServiceModel.Web (in System.ServiceModel.Web.dll)

System.Object
  System.ServiceModel.Activation.ServiceHostFactoryBase
    System.ServiceModel.Activation.ServiceHostFactory
      System.ServiceModel.Activation.WebScriptServiceHostFactory

public class WebScriptServiceHostFactory : ServiceHostFactory

NameDescription
System_CAPS_pubmethodWebScriptServiceHostFactory()

Initializes a new instance of the WebScriptServiceHostFactory class.

NameDescription
System_CAPS_pubmethodCreateServiceHost(String, Uri[])

Creates a ServiceHost with specific base addresses and initializes it with specified data.(Inherited from ServiceHostFactory.)

System_CAPS_protmethodCreateServiceHost(Type, Uri[])

Creates a derived class of ServiceHost for a specified type of service with a specific base address that can be used to automatically enable ASP.NET AJAX endpoints in certain scenarios.(Overrides ServiceHostFactory.CreateServiceHost(Type, Uri[]).)

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

This factory provides a way to add an ASP.NET AJAX endpoint to a service without requiring configuration. The endpoint is added to any other endpoints that are defined in configuration, if any. The managed hosting environments that support this type of dynamic host activation are Internet Information Services (IIS) and Windows Process Activation Services (WAS).

To use this factory, specify the WebScriptServiceHostFactory in the Factory attribute of the @ServiceHost directive.

The ASP.NET AJAX endpoint created by this factory is configured with the WebHttpBinding and the WebScriptEnablingBehavior, with all the default settings. The endpoint is created at an empty address relative to the .svc file. If service configuration already defines an endpoint at this address, an InvalidOperationException is thrown and the service fails to start.

Specify the WebScriptServiceHostFactory for the value of the Factory attribute in the @ServiceHost directive to activate an ASP.NET AJAX endpoint for the MyService service as shown in the following example.

<% @ServiceHost 
Service="MyService"
Language="C#"
Debug="true"
Factory="WebScriptServiceHostFactory"
%>

.NET Framework
Available since 3.5

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft