Inet6Address 類別

定義

命名空間:: Java.Net

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

此類別代表網際網路協定版本6（IPv6）位址。

[Android.Runtime.Register("java/net/Inet6Address", DoNotGenerateAcw=true)]
public sealed class Inet6Address : Java.Net.InetAddress

[<Android.Runtime.Register("java/net/Inet6Address", DoNotGenerateAcw=true)>]
type Inet6Address = class
    inherit InetAddress

繼承: Object

JavaObject

Object

InetAddress
Inet6Address

屬性: RegisterAttribute

備註

此類別代表網際網路協定版本6（IPv6）位址。由 RFC 定義;2373：IP 版本 6 位址架構http://www.ietf.org/rfc/rfc2373.txt。

用於輸入方法的 IPv6 位址的文字表示形式有以下一種：

<李奧爾><>

「lform」>首選形式為 x：x：x：x：x：x：x：x，其中 'x 是位址中八個 16 位元片段的十六進位值。這是完整版。例如，

請注意，不必在單一欄位中寫出前置零。然而，除了下文所述外，每個欄位中必須至少有一個數字。</李>

<李>

由於某些 IPv6 位址類型分配方式，位址通常會包含長串零位元。為了讓寫入包含零位元的位址更簡便，有一種特殊的語法可以用來壓縮零位元。使用「：：」表示有多組 16 位元的零。「：：」只能在一個地址中出現一次。「：：」也可用來壓縮位址中的前置和/或尾部零。例如，

<李>

另一種在處理 IPv4 與 IPv6 混合環境時較方便的替代形式是 x：x：x：x：x：x：x：d.d.d.d，其中 'x 是位址中六個高階 16 位元段的十六進位值，'d 是標準 IPv4 表示位址中四個低階 8 位元段的十進位值，例如，

其中「：：FFFF：d.d.d.d」與「：:d.d.d.d」分別是 IPv4 映射 IPv6 位址與相容 IPv6 位址的一般形式。請注意，IPv4 部分必須以「d.d.d.d」的形式呈現。以下表格無效：

形式如下：

是有效的，但它是 IPv4 相容 IPv6 位址的非傳統表示，

而「：:d」則對應一般 IPv6 位址「0：0：0：0：0：0：0：d」。</li></ol>

對於回傳文字表示作為輸出值的方法，則使用完整表態。 Inet6Address 會回傳完整表單，因為它與其他文字資料結合使用時是明確無歧義的。

<blockquote><table cellspacing=2 summary=“IPv4映射地址描述”><tr><th valign=top>IPv4映射地址</th><td>形式為：：ffff：w.x.y.z，此IPv6地址用來表示IPv4地址。它允許原生程式在與 IPv4 和 IPv6 節點通訊時，使用相同的位址資料結構及相同的套接字。

在 InetAddress 和 Inet6Address 中，它用於內部表示;它沒有功能性角色。 Java 永遠不會回傳 IPv4 映射的位址。這些類別可以輸入 IPv4 映射的位址，無論是位元組陣列還是文字表示。不過，它會被轉換成 IPv4 位址。</td></tr></table/blockquote><>

<h4>“scoped”> IPv6 範圍地址<的文字表示/h4>

上述 IPv6 位址的文字表示可擴展至指定 IPv6 範圍位址。此對基本位址架構的擴充詳見 [draft-ietf-ipngwg-scoping-arch-04.txt]。

由於連結本地與站點本地位址為非全域，不同主機可能擁有相同的目的位址，且可透過同一起源系統中不同介面存取。在這種情況下，起始系統被稱為連接於同一範圍的多個區域。為了釐清目的地區域，可以在 IPv6 位址後附加區域識別碼（或 scope_id）。

指定 scope_id 的一般格式如下：

<blockquote>IPv6 位址%scope_id</blockquote>

IPv6 位址就是如上所述的字面上的 IPv6 位址。 scope_id指的是本地系統上的介面，且可用兩種方式指定。 <ol><li>作為數字識別碼。 此整數必須為正整數，能識別系統所理解的特定介面與作用範圍。通常，數值可透過系統上的管理工具來判定。每個介面可以有多個值，分別對應每個範圍。若作用域未指定，則預設值為零。</李><麗>如線。 這必須是該特定介面所回傳 java.net.NetworkInterface#getName() 的精確字串。當以這種方式建立 Inet6Address 時，數值範圍 ID 會在物件建立時透過查詢相關的 NetworkInterface 確定。</li></ol>

另外請注意，數值 scope_id 可從 NetworkInterface 類別回傳的 Inet6Address 實例中取得。此資料可用來查詢系統中目前設定的範圍 ID。

在 1.4 版本加入。

Java 文件 java.net.Inet6Address。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

屬性

名稱	Description
CanonicalHostName	取得該 IP 位址的完整限定網域名稱。 (繼承來源 InetAddress)
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HostAddress	在文字呈現時回傳 IP 位址字串。 (繼承來源 InetAddress)
HostName	會取得這個 IP 位址的主機名稱。 (繼承來源 InetAddress)
IsAnyLocalAddress	用來檢查萬用字元位址中的 InetAddress 工具例程。 (繼承來源 InetAddress)
IsIPv4CompatibleAddress	用來檢查 InetAddress 是否為 IPv4 相容的 IPv6 位址的工具程式。
IsLinkLocalAddress	用來檢查 InetAddress 是否為連結本地位址的工具程序。 (繼承來源 InetAddress)
IsLoopbackAddress	用來檢查 InetAddress 是否為迴圈位址的工具程序。 (繼承來源 InetAddress)
IsMCGlobal	用來檢查多播位址是否有全域範圍的工具程序。 (繼承來源 InetAddress)
IsMCLinkLocal	用來檢查多播位址是否有連結範圍的工具程序。 (繼承來源 InetAddress)
IsMCNodeLocal	用來檢查多播位址是否有節點範圍的工具程序。 (繼承來源 InetAddress)
IsMCOrgLocal	用來檢查多播位址是否有組織範圍的工具程序。 (繼承來源 InetAddress)
IsMCSiteLocal	用來檢查多播位址是否有站點範圍的工具程序。 (繼承來源 InetAddress)
IsMulticastAddress	用來檢查 InetAddress 是否為 IP 多播位址的工具程序。 (繼承來源 InetAddress)
IsSiteLocalAddress	用來檢查 InetAddress 是否為站點本地位址的工具程序。 (繼承來源 InetAddress)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
JniPeerMembers	此類別代表網際網路協定版本6（IPv6）位址。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ScopedInterface	如果這個實例是以有作用域介面建立，則會回傳有作用域的介面。
ScopeId	如果此實例與介面相關聯，則回傳數值範圍 Id。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 InetAddress)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 InetAddress)

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
Equals(Object)	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetAddress()	回傳此 `InetAddress` 物件的原始 IP 位址。 (繼承來源 InetAddress)
GetByAddress(String, Byte[], Int32)	建立 Inet6Address 的方式與完全 `InetAddress#getByAddress(String,byte[])` 相同，但 IPv6 scope_id 設定為給定的數值。
GetByAddress(String, Byte[], NetworkInterface)	建立 Inet6Address 的方式與完全 `InetAddress#getByAddress(String,byte[])` 相同，但 IPv6 scope_id 設定為對應於指定介面的值，該位址類型在 `addr`。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IsReachable(Int32)	測試該地址是否可達。 (繼承來源 InetAddress)
IsReachable(NetworkInterface, Int32, Int32)	測試該地址是否可達。 (繼承來源 InetAddress)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	此類別代表網際網路協定版本6（IPv6）位址。 (繼承來源 InetAddress)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	此類別代表網際網路協定版本6（IPv6）位址。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於