HttpsTransportBindingElement HttpsTransportBindingElement HttpsTransportBindingElement Class


Represents the binding element used to specify an HTTPS transport for transmitting messages.

public ref class HttpsTransportBindingElement : System::ServiceModel::Channels::HttpTransportBindingElement, System::ServiceModel::Channels::ITransportTokenAssertionProvider
public class HttpsTransportBindingElement : System.ServiceModel.Channels.HttpTransportBindingElement, System.ServiceModel.Channels.ITransportTokenAssertionProvider
Public Class HttpsTransportBindingElement
Inherits HttpTransportBindingElement
Implements ITransportTokenAssertionProvider


The HttpsTransportBindingElement class is the starting point for creating a custom binding that implements the HTTPS transport protocol. HTTPS is the primary transport used for secure interoperability purposes. HTTPS is supported by the Windows Communication Foundation (WCF) to ensure interoperability with other Web services stacks.

The WCF service model uses this class to create factory objects that implement the IChannelFactory and IChannelListener interfaces. These factory objects, in turn, create the channels and listeners that transmit SOAP messages using the HTTPS protocol.

You control the configuration of the factories that this class creates by setting its properties, such as: RequireClientCertificate.

You can also set properties on the base class, HttpTransportBindingElement, such as: AuthenticationScheme, HostNameComparisonMode, and MaxBufferSize.

You can also set properties on the base class TransportBindingElement, such as: ManualAddressing, and MaxBufferPoolSize. For a complete list of properties, see TransportBindingElement.


HttpsTransportBindingElement() HttpsTransportBindingElement() HttpsTransportBindingElement()

Initializes a new instance of the HttpsTransportBindingElement class.

HttpsTransportBindingElement(HttpsTransportBindingElement) HttpsTransportBindingElement(HttpsTransportBindingElement) HttpsTransportBindingElement(HttpsTransportBindingElement)

Initializes a new instance of the HttpsTransportBindingElement class.


AllowCookies AllowCookies AllowCookies

Gets or sets a value that indicates whether the client accepts cookies and propagates them on future requests.

(Inherited from HttpTransportBindingElement)
AuthenticationScheme AuthenticationScheme AuthenticationScheme

Gets or sets the authentication scheme used to authenticate client requests being processed by an HTTP listener.

(Inherited from HttpTransportBindingElement)
BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal

Gets or sets a value that indicates whether proxies are ignored for local addresses.

(Inherited from HttpTransportBindingElement)
DecompressionEnabled DecompressionEnabled DecompressionEnabled

Gets or sets whether the process for returning compressed message data to its original size and format is enabled.

(Inherited from HttpTransportBindingElement)
ExtendedProtectionPolicy ExtendedProtectionPolicy ExtendedProtectionPolicy

Gets or sets the value of the extended security policy used by the server to validate incoming client connections.

(Inherited from HttpTransportBindingElement)
HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode

Gets or sets a value that indicates whether the hostname is used to reach the service when matching on the URI.

(Inherited from HttpTransportBindingElement)
KeepAliveEnabled KeepAliveEnabled KeepAliveEnabled

Gets or sets a value that indicates whether to make a persistent connection to a service endpoint.

(Inherited from HttpTransportBindingElement)
LegacyExtendedProtectionPolicy LegacyExtendedProtectionPolicy LegacyExtendedProtectionPolicy Inherited from HttpTransportBindingElement
ManualAddressing ManualAddressing ManualAddressing

Gets or sets a value that indicates whether manual addressing of the message is required.

(Inherited from TransportBindingElement)
MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

Gets or sets the maximum size, in bytes, of any buffer pools used by the transport.

(Inherited from TransportBindingElement)
MaxBufferSize MaxBufferSize MaxBufferSize

Gets or sets the maximum size of the buffer to use. For buffered messages this value is the same as MaxReceivedMessageSize. For streamed messages, this value is the maximum size of the SOAP headers, which must be read in buffered mode.

(Inherited from HttpTransportBindingElement)
MaxPendingAccepts MaxPendingAccepts MaxPendingAccepts

Gets or sets the maximum number of connections the service can accept simultaneously.

(Inherited from HttpTransportBindingElement)
MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize

Gets and sets the maximum allowable message size, in bytes, that can be received.

(Inherited from TransportBindingElement)
MessageHandlerFactory MessageHandlerFactory MessageHandlerFactory

Gets or sets the Http transport message handler factory.

(Inherited from HttpTransportBindingElement)
ProxyAddress ProxyAddress ProxyAddress

Gets or sets a URI that contains the address of the proxy to use for HTTP requests.

(Inherited from HttpTransportBindingElement)
ProxyAuthenticationScheme ProxyAuthenticationScheme ProxyAuthenticationScheme

Gets or sets the authentication scheme used to authenticate client requests being processed by an HTTP proxy.

(Inherited from HttpTransportBindingElement)
Realm Realm Realm

Gets or sets the authentication realm.

(Inherited from HttpTransportBindingElement)
RequestInitializationTimeout RequestInitializationTimeout RequestInitializationTimeout

Gets or sets the requested initialization time out.

(Inherited from HttpTransportBindingElement)
RequireClientCertificate RequireClientCertificate RequireClientCertificate

Gets or sets a value that indicates whether SSL client authentication is required.

Scheme Scheme Scheme

Returns the URI scheme for the transport.

TransferMode TransferMode TransferMode

Gets or sets the transfer mode.

(Inherited from HttpTransportBindingElement)
UnsafeConnectionNtlmAuthentication UnsafeConnectionNtlmAuthentication UnsafeConnectionNtlmAuthentication

Gets or sets a value that indicates whether Unsafe Connection Sharing is enabled on the server. If enabled, NTLM authentication is performed once on each TCP connection.

(Inherited from HttpTransportBindingElement)
UseDefaultWebProxy UseDefaultWebProxy UseDefaultWebProxy

Gets or sets a value that indicates whether the machine-wide proxy settings are used rather than the user specific settings.

(Inherited from HttpTransportBindingElement)
WebSocketSettings WebSocketSettings WebSocketSettings

Gets or sets the web socket configuration of the binding element.

(Inherited from HttpTransportBindingElement)


BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext)

Creates a channel factory of a specified type that can be used to create a channel.

BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext)

Creates a channel listener of a specified type that can be used to create a channel.

CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext)

Determines whether a channel factory of the specified type can be built.

(Inherited from HttpTransportBindingElement)
CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext)

Determines whether a channel listener of the specified type can be built.

(Inherited from HttpTransportBindingElement)
Clone() Clone() Clone()

Creates a copy of the current binding element.

Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext)

Gets a specified object from the BindingContext.

GetTransportTokenAssertion() GetTransportTokenAssertion() GetTransportTokenAssertion()

Gets the XmlElement that represents the transport token used in the security binding.

GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeExtendedProtectionPolicy() ShouldSerializeExtendedProtectionPolicy() ShouldSerializeExtendedProtectionPolicy()

Returns a valueindicating that it is not possible to XAML serialize the extended protection policy.

(Inherited from HttpTransportBindingElement)
ShouldSerializeMessageHandlerFactory() ShouldSerializeMessageHandlerFactory() ShouldSerializeMessageHandlerFactory()

Determines whether the message handler factory should be serialized.

(Inherited from HttpTransportBindingElement)
ShouldSerializeWebSocketSettings() ShouldSerializeWebSocketSettings() ShouldSerializeWebSocketSettings()

Determines whether the web socket settings should be serialized.

(Inherited from HttpTransportBindingElement)
ToString() ToString() ToString()

Returns a string that represents the current object.

(Inherited from Object)
UpdateAuthenticationSchemes(BindingContext) UpdateAuthenticationSchemes(BindingContext) UpdateAuthenticationSchemes(BindingContext)

Updates the transport authentication schemes that contains the binding context.

(Inherited from HttpTransportBindingElement)

Explicit Interface Implementations

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Exports a custom policy assertion about bindings.

(Inherited from HttpTransportBindingElement)
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Writes custom Web Services Description Language (WSDL) elements into the generated WSDL for a contract.

(Inherited from HttpTransportBindingElement)
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Writes custom Web Services Description Language (WSDL) elements into the generated WSDL for an endpoint.

(Inherited from HttpTransportBindingElement)

Applies to