URL 類別

定義

命名空間:

Java.Net

組件:

Mono.Android.dll

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

[Android.Runtime.Register("java/net/URL", DoNotGenerateAcw=true)]
public sealed class URL : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, 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

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

</blockquote>

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

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

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

</blockquote>

的URL語法是由 RFC  所定義;2396：統一資源標識符 (URI) ：由 RFC  修改的一般語法http://www.ietf.org/rfc/rfc2396.txt;2732：URL 中常值 IPv6 位址的格式。http://www.ietf.org/rfc/rfc2732.txt 常值 IPv6 位址格式也支援scope_ids。 此處說明scope_ids的語法和用法。

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

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

</blockquote>

此片段不是 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

</blockquote>

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

URL 類別本身不會根據RFC2396中所定義的逸出機制來編碼或譯碼任何 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，並使用 和URI#toURL()在這兩個類別#toURI()之間轉換。

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

已在 JDK1.0 中新增。

的 java.net.URLJava 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據 中所述的詞彙使用。

建構函式

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

屬性

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

方法

Clone()	建立並傳回這個 對象的複本。 (繼承來源 Object)
Dispose()	類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 Object)
Dispose(Boolean)	類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 Object)
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)
SetURLStreamHandlerFactory(IURLStreamHandlerFactory)	設定應用程式的 URLStreamHandlerFactory。
ToArray<T>()	類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 Object)
ToExternalForm()	建構這個 URL的字串表示。
ToString()	傳回物件的字串表示。 (繼承來源 Object)
ToURI()	傳 java.net.URI 回相當於這個網址的 。
UnregisterFromRuntime()	類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。 (繼承來源 Object)
Wait()	讓目前的線程等到喚醒為止，通常是藉由 <em>notified</em> 或 <em>interrupted</em> 來喚醒。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

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

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。
GetJniTypeName(IJavaPeerable)	類別 URL 代表統一資源定位器，這是萬維網上「資源」的指標。