WebHttpBinding Class

Definition

A binding used to configure endpoints for Windows Communication Foundation (WCF) Web services that are exposed through HTTP requests instead of SOAP messages.

public class WebHttpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
Inheritance
WebHttpBinding
Implements

Remarks

The WCF Web Programming Model allows developers to expose WCF Web services through HTTP requests that use "plain old XML" (POX) style messaging instead of SOAP-based messaging. For clients to communicate with a service using HTTP requests, an endpoint of the service must be configured with the WebHttpBinding that has the WebHttpBehavior attached to it. The WCF Web Programming Model also requires that the individual service operations are annotated with the WebGetAttribute or WebInvokeAttribute attributes. This defines a mapping from a URI and HTTP method to the service operation, as well as the format of the messages used to call the operation and return the results. Support in WCF for syndication and ASP.AJAX integration are both built on top of the WCF Web Programming Model.

Constructors

WebHttpBinding()

Initializes a new instance of the WebHttpBinding class.

WebHttpBinding(String)

Initializes a new instance of the WebHttpBinding class with a binding specified by its configuration name.

WebHttpBinding(WebHttpSecurityMode)

Initializes a new instance of the WebHttpBinding class with the type of security used by the binding explicitly specified.

Properties

AllowCookies

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

BypassProxyOnLocal

Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

CloseTimeout

Gets or sets the interval of time provided for a connection to close before the transport raises an exception.

(Inherited from Binding)
ContentTypeMapper

Gets or sets the content type mapper.

CrossDomainScriptAccessEnabled

Gets or sets a value that determines if cross domain script access is enabled.

EnvelopeVersion

Gets the envelope version that is used by endpoints that are configured by this binding to receive HTTP requests.

HostNameComparisonMode

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

MaxBufferPoolSize

Gets or sets the maximum amount of memory allocated, in bytes, for the buffer manager that manages the buffers required by endpoints that use this binding.

MaxBufferSize

Gets or sets the maximum amount of memory, in bytes, that is allocated for use by the manager of the message buffers that receive messages from the channel.

MaxReceivedMessageSize

Gets or sets the maximum size, in bytes, for a message that can be processed by the binding.

MessageVersion

Gets the message version used by clients and services configured with the binding.

(Inherited from Binding)
Name

Gets or sets the name of the binding.

(Inherited from Binding)
Namespace

Gets or sets the XML namespace of the binding.

(Inherited from Binding)
OpenTimeout

Gets or sets the interval of time provided for a connection to open before the transport raises an exception.

(Inherited from Binding)
ProxyAddress

Gets or sets the URI address of the HTTP proxy.

ReaderQuotas

Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

ReceiveTimeout

Gets or sets the interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.

(Inherited from Binding)
Scheme

Gets the URI transport scheme for the channels and listeners that are configured with this binding.

Security

Gets the security settings used with this binding.

SendTimeout

Gets or sets the interval of time provided for a write operation to complete before the transport raises an exception.

(Inherited from Binding)
TransferMode

Gets or sets a value that indicates whether the service configured with the binding uses streamed or buffered (or both) modes of message transfer.

UseDefaultWebProxy

Gets or sets a value that indicates whether the auto-configured HTTP proxy of the system should be used, if available.

WriteEncoding

Gets or sets the character encoding that is used for the message text.

Methods

BuildChannelFactory<TChannel>(BindingParameterCollection)

Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.

BuildChannelFactory<TChannel>(Object[])

Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.

(Inherited from Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelListener<TChannel>(Object[])

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(Object[])

Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(Object[])

Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.

(Inherited from Binding)
CreateBindingElements()

Returns an ordered collection of binding elements contained in the current binding.

Equals(Object)

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

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

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

Returns a typed object requested, if present, from the appropriate layer in the binding stack.

(Inherited from Binding)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeName()

Returns whether the name of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeNamespace()

Returns whether the namespace of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeReaderQuotas()

Determines if reader quotas should be serialized.

ShouldSerializeSecurity()

Determines if security settings should be serialized.

ShouldSerializeWriteEncoding()

Determines if the encoding used for serialization should be serialized.

ToString()

Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

IBindingRuntimePreferences.ReceiveSynchronously

Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

Applies to