URL 類別

定義

命名空間:: Java.Net

組件:: Mono.Android.dll

重要

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

類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。

[Android.Runtime.Register("java/net/URL", DoNotGenerateAcw=true)]
public sealed class URL : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("java/net/URL", DoNotGenerateAcw=true)>]
type URL = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承: Object

JavaObject

Object
URL

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ISerializable IDisposable

備註

類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。資源可以像檔案或目錄一樣簡單，或是參考更複雜的物件，例如查詢資料庫或搜尋引擎。如需 URL 類型及其格式的詳細資訊，請參閱： URL 類型http://web.archive.org/web/20051219043731/http://archive.ncsa.uiuc.edu/SDG/Software/Mosaic/Demo/url-primer.html

一般而言，URL 可以分成數個部分。請考慮下列範例： <blockquote>

http://www.example.com/docs/resource1.html

</區塊引用>

上述 URL 表示要使用的通訊協定是 http （超文字傳輸通訊協定），而且資訊位於名為 www.example.com的主機電腦上。該主電腦的資訊名稱為 /docs/resource1.html。主電腦上的這個名稱確切意義與通訊協定相依和主機相依。資訊通常位於檔案中，但可能會實時產生。 URL 的這個元件稱為路徑元件。

URL 可以選擇性地指定「埠」，這是遠端主電腦上 TCP 連線的埠號碼。如果未指定埠，則會改用通訊協議的預設埠。例如，預設埠 http 是 80。替代埠可以指定為： <blockquote>

http://www.example.com:1080/docs/resource1.html

</區塊引用>

的URL語法是由 http://www.ietf.org/rfc/rfc2732.txt 中常值 IPv6 位址的格式。常值 IPv6 位址格式也支援scope_ids。此處將說明scope_ids的語法和用法。

URL 可能已附加至「片段」，也稱為「ref」或「參考」。片段會以尖銳符號字元「#」表示，後面接著更多字元。例如， <blockquote>

http://java.sun.com/index.html#chapter1

</區塊引用>

此片段在技術上不是URL的一部分。相反地，它表示在擷取指定的資源之後，應用程式特別感興趣的是附加卷標的 chapter1 檔部分。卷標的意義是資源特定。

應用程式也可以指定「相對 URL」，其中只包含足夠的資訊，可連線到相對於另一個 URL 的資源。相對 URL 經常在 HTML 頁面中使用。例如，如果 URL 的內容： <blockquote>

http://java.sun.com/index.html

<相對 URL 中包含的 /blockquote> ： <blockquote>

FAQ.html

</blockquote> 會是速記： <blockquote>

http://java.sun.com/FAQ.html

</區塊引用>

相對 URL 不需要指定 URL 的所有元件。如果遺失通訊協定、主機名或埠號碼，則值會繼承自完整指定的 URL。必須指定檔案元件。選擇性片段不會繼承。

根據RFC2396中定義的逸出機制，URL 類別本身不會編碼或譯碼任何 URL 元件。呼叫者必須負責編碼任何字段，這些欄位必須在呼叫 URL 之前逸出，同時也要譯碼從 URL 傳回的任何逸出字段。此外，由於 URL 不知道 URL 逸出，因此它不會識別相同 URL 編碼或譯碼形式的等價。例如，兩個 URL：<br>

http://foo.com/hello world/ and http://foo.com/hello%20world

會被視為不等於彼此。

請注意，類別 java.net.URI 在某些情況下會執行其元件欄位的逸出。管理 URL 編碼和譯碼的建議方式是使用 java.net.URI，並使用和#toURI()在這兩個類別URI#toURL()之間轉換。

URLEncoder和 URLDecoder 類別也可以使用，但只適用於 HTML 格式編碼，這與RFC2396中定義的編碼配置不同。

已在 JDK1.0 中新增。

的 java.net.URLJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱	Description
URL(String, String, Int32, String, URLStreamHandler)	`URL`從指定的 `protocol`、`host`、 `port` number、、 `file`和 `handler`建立物件。
URL(String, String, Int32, String)	`URL`從指定的 `protocol`、`host`、 `port` number 和 `file`建立物件。
URL(String, String, String)	從指定 `protocol` 的名稱、 `host` 名稱和 `file` 名稱建立URL。
URL(String)	從表示法`URL`建立 `String` 物件。
URL(URL, String, URLStreamHandler)	使用指定內容中的指定處理程式剖析指定的規格，以建立URL。
URL(URL, String)	藉由剖析指定內容中的指定規格來建立URL。

屬性

名稱	Description
Authority	取得這個 `URL`的授權單位部分。
Class	傳回這個 `Object`的運行時間類別。 (繼承來源 Object)
Content	取得此 URL 的內容。
DefaultPort	取得與此 `URL`相關聯之通訊協議的預設埠號碼。
File	取得這個 `URL`的檔名。
Handle	基礎Android實例的句柄。 (繼承來源 Object)
Host	如果適用，則取得這個 `URL`的主機名。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
JniPeerMembers	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。
Path	取得這個 `URL`的路徑部分。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Port	取得這個 `URL`的埠號碼。
Protocol	取得這個 `URL`的通訊協定名稱。
Query	取得這個 `URL`的查詢部分。
Ref	取得這個 `URL`的錨點（也稱為「參考」）。
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)
UserInfo	取得這個 `URL`的userInfo部分。

方法

名稱	Description
Clone()	建立並傳回這個對象的複本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
Equals(Object)	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
GetContent(Class[])	取得此 URL 的內容。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾收集決定不再參考物件時，垃圾收集行程在物件上呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
OpenConnection()	傳 `java.net.URLConnection URLConnection` 回實例，表示與所 `URL`參考之遠端對象的連接。
OpenConnection(Proxy)	與 `#openConnection()`相同，不同之處在於聯機會透過指定的 Proxy 進行;不支援 Proxy 的通訊協定處理程式會忽略 Proxy 參數並建立一般連線。
OpenStream()	開啟此 `URL` 連線 `InputStream` 讀取的連線。
SameFile(URL)	比較兩個 URL，不包括片段元件。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
SetURLStreamHandlerFactory(IURLStreamHandlerFactory)	設定應用程式的 `URLStreamHandlerFactory`。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToExternalForm()	建構這個 `URL`的字串表示。
ToString()	傳回物件的字串表示。 (繼承來源 Object)
ToURI()	傳 `java.net.URI` 回相當於這個網址的。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	類別 `URL` 代表統一資源定位器，這是萬維網上「資源」的指標。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於