Edit

Share via


ServiceHostingEnvironment.EnsureServiceAvailable(String) Method

Definition

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

A service at given virtual path cannot be found.

The service fails to activate successfully.

The service is not running in the hosted environment.

virtualPath is null.

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