ServiceHostingEnvironment.EnsureServiceAvailable(String) Method
Definition
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
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.