ChannelDispatcherBase.Attach(ServiceHostBase) Method

Reference

Definition

Namespace:: System.ServiceModel.Dispatcher

Assembly:: System.ServiceModel.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.

When overridden in a derived class, attaches the channel dispatcher to a specific host.

protected:
 virtual void Attach(System::ServiceModel::ServiceHostBase ^ host);

protected virtual void Attach (System.ServiceModel.ServiceHostBase host);

abstract member Attach : System.ServiceModel.ServiceHostBase -> unit
override this.Attach : System.ServiceModel.ServiceHostBase -> unit

Protected Overridable Sub Attach (host As ServiceHostBase)

Parameters

host: ServiceHostBase

The ServiceHostBase for the service.

Exceptions

ArgumentNullException

host is null.

InvalidOperationException

The communication object is in an Opening or Opened state or the host is already set.

ObjectDisposedException

The communication object is in a Closing or Closed state.

CommunicationObjectFaultedException

The communication object is in a Faulted state.

Remarks

This method can only be set when the instance of the ChannelDispatcher is in the Created state, as this is the only state that is both mutable and not disposed.

A ServiceHost calls this method when the ChannelDispatcherBase is added to its ChannelDispatchers collection. This gives the ChannelDispatcherBase a chance to hook events and inspect the ServiceHost, and provides the value that should be returned from the Host property.

Applies to