Export (0) Print
Expand All

HttpCookieContainerBindingElement Class

Enables management of how HTTP cookies are handled in HTTP requests and responses.

System.Object
  System.ServiceModel.Channels.BindingElement
    System.ServiceModel.Channels.HttpCookieContainerBindingElement

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

public class HttpCookieContainerBindingElement : BindingElement

The HttpCookieContainerBindingElement type exposes the following members.

  NameDescription
Public methodSupported by Silverlight for Windows PhoneHttpCookieContainerBindingElement()Initializes a new instance of the HttpCookieContainerBindingElement class.
Protected methodSupported by Silverlight for Windows PhoneHttpCookieContainerBindingElement(HttpCookieContainerBindingElement)Initializes a new instance of the HttpCookieContainerBindingElement class from a specified binding element.
Top

  NameDescription
Public methodSupported by Silverlight for Windows PhoneBuildChannelFactory<TChannel>Initializes a channel factory for producing channels of a specified type from the binding context. (Overrides BindingElement.BuildChannelFactory<TChannel>(BindingContext).)
Public methodSupported by Silverlight for Windows PhoneCanBuildChannelFactory<TChannel>Returns a value that indicates whether the binding element can build a channel factory for a specific type of channel. (Inherited from BindingElement.)
Public methodSupported by Silverlight for Windows PhoneCloneReturns a copy of the current binding element object. (Overrides BindingElement.Clone().)
Public methodSupported by Silverlight for Windows PhoneEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneFinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneGetProperty<T>Returns a typed object requested, if present, from the appropriate layer in the binding stack. (Overrides BindingElement.GetProperty<T>(BindingContext).)
Public methodSupported by Silverlight for Windows PhoneGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneToStringReturns a string that represents the current object. (Inherited from Object.)
Top

You can specify an instance of CookieContainer to be used when issuing an HTTP request. Any cookies in the CookieContainer applicable to the request will automatically be included when the HTTP request is made, and any cookies that are returned as part of the HTTP response will automatically be placed in the CookieContainer.

The same CookieContainer instance can be used for multiple channels, which is often useful when one service is used to provide cookies for authentication and another service requires these authentication cookies provided by the first service. To gain access to the CookieContainer instance, call GetProperty<T>() on a channel constructed from a binding that included the HttpCookieContainerBindingElement, using the IHttpCookieContainerManager type parameter. Then, access the CookieContainer property. The property is null by default, signifying that no CookieContainer should be used.

Using HttpCookieContainerBindingElement to manage cookies is necessary only when you have registered an alternative HTTP stack using RegisterPrefix. The default browser-based HTTP stack in Silverlight 5 automatically uses the browser’s cookie repository and does not require this mechanism. If you attempt to set a CookieContainer using this mechanism with the browser-based HTTP stack, the channel will throw an exception when attempting to issue an HTTP request.

NoteNote:

The HttpCookieContainerBindingElement works only with the HttpTransportBindingElement and HttpsTransportBindingElement transport binding elements.

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

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

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

Community Additions

ADD
Show:
© 2014 Microsoft