IPAddress.ScopeId プロパティ

.NET Framework クラス ライブラリ リファレンス

IPAddress.ScopeId プロパティ

IPv6 アドレスのスコープ識別子を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property ScopeId As
 Long

Visual Basic (使用法)

Dim instance As IPAddress
Dim value As Long

value = instance.ScopeId

instance.ScopeId = value

C#

public long ScopeId { get; set;
 }

C++

public:
property long long ScopeId {
    long long get ();
    void set (long long value);
}

J#

/** @property */
public long get_ScopeId ()

/** @property */
public void set_ScopeId (long value)

JScript

public function get ScopeId
 () : long

public function set ScopeId
 (value : long)

プロパティ値
アドレスのスコープを指定する長整数。

例外

例外の種類	条件
SocketException	AddressFamily = InterNetwork
ArgumentOutOfRangeException	scopeId < 0 または scopeId > 0x00000000FFFFFFFF

解説

ScopeId の意味は、それが使用されているコンテキストによって異なります。

• リンクローカル アドレスの場合。異なるリンクに接続している複数のインターフェイスを持つホストで、同じリンクローカル アドレスを複数のインターフェイスに割り当てることができます。このあいまいさを避けるために、スコープ識別子を使用して、メッセージの交換に使用するインターフェイスを指定します。

メモ
Format Prefix (FP) FE80 によって識別されるリンクローカル アドレスは、同じリンク上の近隣のノードと通信するときにノードによって使用されます。

• サイトローカル アドレスの場合。複数のサイトにホストが接続できます。この場合、スコープ識別子は通信先の特定のサイトを示すときに使用します。

メモ
Format Prefix (FP) FEC0 によって識別されるサイトローカル アドレスは、プライベート イントラネット上で通信するときにノードによって使用されます。

ScopeId とアドレスを指定するときに使用する表記は Address%ScopeId です。たとえば、FE80::5EFE:192.168.41.30%2. です。

使用例

Visual Basic

' 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

C#

// 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());

J#

// 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()));
}

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
IPAddress クラス
IPAddress メンバ
System.Net 名前空間