Edit

SecurityBindingElement.BuildChannelFactory<TChannel> Method

  • Reference

Definition

Namespace:
System.ServiceModel.Channels
Assembly:
System.ServiceModel.Security.dll
Assembly:
System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.dll
Package:
System.ServiceModel.Primitives v6.0.0
Package:
System.ServiceModel.Primitives v6.2.0
Source:
SecurityBindingElement.cs
Source:
SecurityBindingElement.cs
Source:
SecurityBindingElement.cs

Creates a channel factory based on the SecurityBindingElement settings and the binding context passed in. The channel factory created is a SOAP message security channel factory, which internally has a reference to the channel factory that corresponds to the binding context, (which includes the transport channel factory).

public:
generic <typename TChannel>
 override System::ServiceModel::Channels::IChannelFactory<TChannel> ^ BuildChannelFactory(System::ServiceModel::Channels::BindingContext ^ context);
public override System.ServiceModel.Channels.IChannelFactory<TChannel> BuildChannelFactory<TChannel> (System.ServiceModel.Channels.BindingContext context);
override this.BuildChannelFactory : System.ServiceModel.Channels.BindingContext -> System.ServiceModel.Channels.IChannelFactory<'Channel>
Public Overrides Function BuildChannelFactory(Of TChannel) (context As BindingContext) As IChannelFactory(Of TChannel)

Type Parameters

TChannel

The type of channel factory.

Parameters

context
BindingContext

The BindingContext.

Returns

IChannelFactory<TChannel>

A channel factory based on the SecurityBindingElement settings and the binding context passed in.

Exceptions

ArgumentNullException

context is null.

ArgumentException

A channel of type TChannel is not supported.

Remarks

The channel factory created is a SOAP message security channel factory, which internally has a reference to the channel factory that corresponds to the binding context, (which includes the transport channel factory).

This method does parameter error-checking, and then calls BuildChannelFactoryCore. That method, when implemented in a derived class, creates a channel factory, which is used to create a channel that processes outgoing messages for this binding.

Applies to