BinaryMessageEncodingBindingElement.Clone Method

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

Creates a new BinaryMessageEncodingBindingElement object initialized from the current one.

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

Syntax

'Declaration
Public Overrides Function Clone As BindingElement
public override BindingElement Clone()

Return Value

Type: System.ServiceModel.Channels.BindingElement
A BinaryMessageEncodingBindingElement object with property values equal to those of the current element.

Remarks

This creates a complete copy of the current binding element object tree, also called a deep clone. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This can also be described as copying the entire object graph.) Returning a deep clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a deep clone is not returned, the runtime behavior is undefined.

A shallow clone of an object, by contrast, is a copy of the object only. If the object contains references to other objects, the shallow copy does not create copies of the referenced objects; instead, it copies only the references to the original objects.

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.