Binding.Name Property

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

Gets or sets the name of the binding.

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

Syntax

'Declaration
Public Property Name As String
public string Name { get; set; }

Property Value

Type: System.String
The name of the binding. The default name is nulla null reference (Nothing in Visual Basic).

Exceptions

Exception Condition
ArgumentException

The value set cannot be nulla null reference (Nothing in Visual Basic) or an empty string.

Remarks

Each instance of a Binding has a Name and Namespace that together uniquely identify the user name for the binding in the metadata of the service.

This user name for the binding is distinct from the specification of the protocol name, which is specified by the Scheme property. If you want to add more HTTP bindings, for example, you can name them whatever you want and set all of their schemes to "http". There is no inherent application or machine dispatch based on the Scheme. So you avoid the common problem of being unable to register additional handlers for well-known protocols. You can also easily work with multiple versions of a binding side-by-side by giving each version a different name.

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.