ServiceHostingEnvironment.EnsureServiceAvailable(String) Method

Reference

Definition

Namespace:: System.ServiceModel

Assembly:: System.ServiceModel.dll

Assembly:: System.ServiceModel.Activation.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Ensures that a service is activated at the provided virtual path.

public:
 static void EnsureServiceAvailable(System::String ^ virtualPath);

public static void EnsureServiceAvailable (string virtualPath);

static member EnsureServiceAvailable : string -> unit

Public Shared Sub EnsureServiceAvailable (virtualPath As String)

Parameters

virtualPath: String

The virtual path to the service.

Exceptions

EndpointNotFoundException

A service at given virtual path cannot be found.

ServiceActivationException

The service fails to activate successfully.

InvalidOperationException

The service is not running in the hosted environment.

ArgumentNullException

virtualPath is null.

ArgumentException

virtualPath is an absolute URI or not valid.

Remarks

This method is used by third-party transport developers to activate the service at the provided virtual path if that service is not already active. This method is idempotent so that once it has been called, calling it again with the same virtualPath specified is safe in the sense that it has no effect.

The expected virtual path format is /<app-name>/<sub-directory/<service-name>.svc or ~/<sub-directory/<service-name>.svc where <app-name> is the application name, <sub-directory> is the IIS virtual directory, and <service-name> is the service name.

Applies to