This documentation is archived and is not being maintained.

ServiceHostBase.OnClose Method

Closes down the hosted service, including their channel dispatchers and associated instance contexts and listeners.

Namespace: System.ServiceModel
Assembly: System.ServiceModel (in system.servicemodel.dll)

protected override void OnClose (
	TimeSpan timeout
protected void OnClose (
	TimeSpan timeout
protected override function OnClose (
	timeout : TimeSpan
Not applicable.



The Timespan that specifies how long the on-close operation has to complete before timing out.

Calling OnClose does the following:

  • Closes all input to ChannelDispatcher, which also closes their associated IChannelListener instances. This stops any new channels from being accepting.

  • Calls CloseInput on all InstanceContext objects which mean they will stop accepting new messages.

  • Waits for all InstanceContext objects to close down which happens when their associated channels finish sending all pending messages.

  • Closes the ChannelDispatcher objects associated with the host.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0