Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
HttpsTransportBindingElement Class
Collapse the table of content
Expand the table of content

HttpsTransportBindingElement Class

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

Namespace:  System.ServiceModel.Channels
Assemblies:   System.ServiceModel.Http (in System.ServiceModel.Http.dll)
  System.ServiceModel (in System.ServiceModel.dll)

public class HttpsTransportBindingElement : HttpTransportBindingElement

The HttpsTransportBindingElement type exposes the following members.

  NameDescription
Public methodSupported by Portable Class LibraryHttpsTransportBindingElement()Initializes a new instance of the HttpsTransportBindingElement class.
Protected methodSupported by Portable Class LibraryHttpsTransportBindingElement(HttpsTransportBindingElement)Initializes a new instance of the HttpsTransportBindingElement class.
Top

  NameDescription
Public propertyAllowCookiesGets or sets a value that indicates whether the client accepts cookies and propagates them on future requests. (Inherited from HttpTransportBindingElement.)
Public propertyAuthenticationSchemeGets or sets the authentication scheme used to authenticate client requests being processed by an HTTP listener. (Inherited from HttpTransportBindingElement.)
Public propertyBypassProxyOnLocalGets or sets a value that indicates whether proxies are ignored for local addresses. (Inherited from HttpTransportBindingElement.)
Public propertyDecompressionEnabledGets or sets whether the process for returning compressed message data to its original size and format is enabled. (Inherited from HttpTransportBindingElement.)
Public propertyExtendedProtectionPolicyGets or sets the value of the extended security policy used by the server to validate incoming client connections. (Inherited from HttpTransportBindingElement.)
Public propertyHostNameComparisonModeGets or sets a value that indicates whether the hostname is used to reach the service when matching on the URI. (Inherited from HttpTransportBindingElement.)
Public propertyKeepAliveEnabledGets or sets a value that indicates whether to make a persistent connection to a service endpoint. (Inherited from HttpTransportBindingElement.)
Public propertySupported by Portable Class LibraryManualAddressingGets or sets a value that indicates whether manual addressing of the message is required. (Inherited from TransportBindingElement.)
Public propertyMaxBufferPoolSizeGets or sets the maximum size, in bytes, of any buffer pools used by the transport. (Inherited from TransportBindingElement.)
Public propertySupported by Portable Class LibraryMaxBufferSizeGets 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.)
Public propertyMaxPendingAcceptsGets or sets the maximum number of connections the service can accept simultaneously. (Inherited from HttpTransportBindingElement.)
Public propertySupported by Portable Class LibraryMaxReceivedMessageSizeGets and sets the maximum allowable message size, in bytes, that can be received. (Inherited from TransportBindingElement.)
Public propertyMessageHandlerFactoryGets or sets the Http transport message handler factory. (Inherited from HttpTransportBindingElement.)
Public propertyProxyAddressGets or sets a URI that contains the address of the proxy to use for HTTP requests. (Inherited from HttpTransportBindingElement.)
Public propertyProxyAuthenticationSchemeGets or sets the authentication scheme used to authenticate client requests being processed by an HTTP proxy. (Inherited from HttpTransportBindingElement.)
Public propertyRealmGets or sets the authentication realm. (Inherited from HttpTransportBindingElement.)
Public propertyRequestInitializationTimeoutGets or sets the requested initialization time out. (Inherited from HttpTransportBindingElement.)
Public propertyRequireClientCertificateGets or sets a value that indicates whether SSL client authentication is required.
Public propertySupported by Portable Class LibrarySchemeReturns the URI scheme for the transport. (Overrides HttpTransportBindingElement.Scheme.)
Public propertyTransferModeGets or sets the transfer mode. (Inherited from HttpTransportBindingElement.)
Public propertyUnsafeConnectionNtlmAuthenticationGets 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.)
Public propertyUseDefaultWebProxyGets or sets a value that indicates whether the machine-wide proxy settings are used rather than the user specific settings. (Inherited from HttpTransportBindingElement.)
Public propertyWebSocketSettingsGets or sets the web socket configuration of the binding element. (Inherited from HttpTransportBindingElement.)
Top

  NameDescription
Public methodSupported by Portable Class LibraryBuildChannelFactory<TChannel>Creates a channel factory of a specified type that can be used to create a channel. (Overrides HttpTransportBindingElement.BuildChannelFactory<TChannel>(BindingContext).)
Public methodBuildChannelListener<TChannel>Creates a channel listener of a specified type that can be used to create a channel. (Overrides HttpTransportBindingElement.BuildChannelListener<TChannel>(BindingContext).)
Public methodSupported by Portable Class LibraryCanBuildChannelFactory<TChannel>Determines whether a channel factory of the specified type can be built. (Inherited from HttpTransportBindingElement.)
Public methodCanBuildChannelListener<TChannel>Determines whether a channel listener of the specified type can be built. (Inherited from HttpTransportBindingElement.)
Public methodSupported by Portable Class LibraryCloneCreates a copy of the current binding element. (Overrides HttpTransportBindingElement.Clone().)
Public methodSupported by Portable Class LibraryEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodSupported by Portable Class LibraryFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Portable Class LibraryGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetProperty<T>Gets a specified object from the BindingContext. (Overrides HttpTransportBindingElement.GetProperty<T>(BindingContext).)
Public methodGetTransportTokenAssertionGets the XmlElement that represents the transport token used in the security binding.
Public methodSupported by Portable Class LibraryGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodSupported by Portable Class LibraryMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodShouldSerializeExtendedProtectionPolicyReturns a valueindicating that it is not possible to XAML serialize the extended protection policy. (Inherited from HttpTransportBindingElement.)
Public methodShouldSerializeMessageHandlerFactoryDetermines whether the message handler factory should be serialized. (Inherited from HttpTransportBindingElement.)
Public methodShouldSerializeWebSocketSettingsDetermines whether the web socket settings should be serialized. (Inherited from HttpTransportBindingElement.)
Public methodSupported by Portable Class LibraryToStringReturns a string that represents the current object. (Inherited from Object.)
Protected methodUpdateAuthenticationSchemesUpdates the transport authentication schemes that contains the binding context. (Inherited from HttpTransportBindingElement.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIPolicyExportExtension.ExportPolicyExports a custom policy assertion about bindings. (Inherited from HttpTransportBindingElement.)
Explicit interface implemetationPrivate methodIWsdlExportExtension.ExportContractWrites custom Web Services Description Language (WSDL) elements into the generated WSDL for a contract. (Inherited from HttpTransportBindingElement.)
Explicit interface implemetationPrivate methodIWsdlExportExtension.ExportEndpointWrites custom Web Services Description Language (WSDL) elements into the generated WSDL for an endpoint. (Inherited from HttpTransportBindingElement.)
Top

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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2015 Microsoft