Freigeben über


IPAddress.ScopeId-Eigenschaft

Ruft den Bezeichner für den Gültigkeitsbereich der IPv6-Adresse ab oder legt diesen fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property ScopeId As Long
'Usage
Dim instance As IPAddress
Dim value As Long

value = instance.ScopeId

instance.ScopeId = value
public long ScopeId { get; set; }
public:
property long long ScopeId {
    long long get ();
    void set (long long value);
}
/** @property */
public long get_ScopeId ()

/** @property */
public void set_ScopeId (long value)
public function get ScopeId () : long

public function set ScopeId (value : long)

Eigenschaftenwert

Ein lange ganze Zahl, die den Gültigkeitsbereich der Adresse angibt.

Ausnahmen

Ausnahmetyp Bedingung

SocketException

AddressFamily = InterNetwork.

ArgumentOutOfRangeException

scopeId < 0

– oder –

  • scopeId > 0x00000000FFFFFFFF

Hinweise

Die Bedeutung der ScopeId hängt von dem Kontext ab, in dem sie eingesetzt wird.

  • Link-Local-Adresse. Auf einem Host mit mehreren Schnittstellen, die mit separaten Verknüpfungen verbunden sind, kann dieselbe Link-Local-Adresse mehreren Schnittstellen zugewiesen werden. Zur Vermeidung dieser Mehrdeutigkeit wird mit einem Bezeichner für einen Gültigkeitsbereich die Schnittstelle angegeben, über die Meldungen ausgetauscht werden.

Hinweis

Durch das Format Prefix (FP) FE80 angegebene Link-Local-Adressen werden von Knoten bei der Kommunikation mit benachbarten Knoten in derselben Verknüpfung verwendet.

  • Site-Local-Adressen. Ein Host kann mit mehreren Sites verbunden sein. Ist dies der Fall, wird mit einem Bezeichner für einen Gültigkeitsbereich eine bestimmte Site für die Kommunikation angegeben.

Hinweis

Durch das Format Prefix (FP) FECO gekennzeichnete Site-Local-Adressen werden von Knoten bei der Kommunikation in privaten Intranets verwendet.

Die Notation, durch die die ScopeId mit einer Adresse angegeben wird, lautet Address%ScopeId . Beispiel: FE80::5EFE:192.168.41.30%2.

Beispiel

' Display the type of address family supported by the server. If the
' server is IPv6-enabled this value is: InternNetworkV6. If the server
' is also IPv4-enabled there will be an additional value of InterNetwork.
Console.WriteLine(("AddressFamily: " + curAdd.AddressFamily.ToString()))

' Display the ScopeId property in case of IPV6 addresses.
If curAdd.AddressFamily.ToString() = ProtocolFamily.InterNetworkV6.ToString() Then
  Console.WriteLine(("Scope Id: " + curAdd.ScopeId.ToString()))
End If
// Display the type of address family supported by the server. If the
// server is IPv6-enabled this value is: InternNetworkV6. If the server
// is also IPv4-enabled there will be an additional value of InterNetwork.
Console.WriteLine("AddressFamily: " + curAdd.AddressFamily.ToString());

// Display the ScopeId property in case of IPV6 addresses.
if(curAdd.AddressFamily.ToString() == ProtocolFamily.InterNetworkV6.ToString())
  Console.WriteLine("Scope Id: " + curAdd.ScopeId.ToString());
// Display the type of address family supported by the server. 
// If the server is IPv6-enabled this value is:InternNetworkV6.
// If the server is also IPv4-enabled there will be an 
// additional value of InterNetwork.
Console.WriteLine(("AddressFamily: " 
    + curAdd.get_AddressFamily().ToString()));

// Display the ScopeId property in case of IPV6 addresses.
if (curAdd.get_AddressFamily().ToString().equals(
        ProtocolFamily.InterNetworkV6.ToString())) {
    Console.WriteLine(("Scope Id: " 
        +(new Long(curAdd.get_ScopeId())).ToString()));
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

IPAddress-Klasse
IPAddress-Member
System.Net-Namespace