• Article

SecurityBindingElement.BuildChannelFactory<TChannel> Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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).

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

Syntax

'Declaration
Public Overrides Function BuildChannelFactory(Of TChannel) ( _
    context As BindingContext _
) As IChannelFactory(Of TChannel)

public override IChannelFactory<TChannel> BuildChannelFactory<TChannel>(
    BindingContext context
)

Type Parameters

  • TChannel
    Type of channel factory.

Exceptions

Exception Condition
ArgumentNullException

context is nulla null reference (Nothing in Visual Basic).
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<TChannel>. 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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.