IPAddress.ScopeId Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets or sets the IPv6 address scope identifier.
Namespace: System.Net
Assembly: System.Net (in System.Net.dll)
Syntax
'Declaration
Public Property ScopeId As Long
public long ScopeId { get; set; }
Property Value
Type: System.Int64
A long integer that specifies the scope of the address.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The value when setting the ScopeId is less than 0 or the value is greater than 0x00000000FFFFFFFF. |
| SocketException | The AddressFamily property is specified as InterNetwork. |
Remarks
The meaning of ScopeId changes depending on the context in which it is used.
- Link-local address. On a host with multiple interfaces connected to separate links, the same link-local address can be assigned to multiple interfaces. To eliminate this ambiguity, a scope identifier is used to specify the interface over which messages are exchanged.
.gif "Note") Note: |
|---|
Link-local addresses, identified by the Format Prefix (FP) FE80, are used by nodes when communicating with neighboring nodes on the same link. |
- Site-local addresses. A host can be connected to multiple sites. In this case, a scope identifier is used to indicate a specific site to communicate with.
| Note: |
|---|
Site-local addresses, identified by the Format Prefix (FP) FEC0, are used by nodes when communicating on private intranets. |
The notation that is used to specify the ScopeId with an address is Address%ScopeId. For example, FE80::5EFE:192.168.41.30%2.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.