URL 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| URL(String) |
從表示 |
| URL(URL, String) |
透過解析指定上下文中的規格來建立 URL。 |
| URL(URL, String, URLStreamHandler) |
透過解析指定的處理器在指定上下文中,建立一個 URL。 |
| URL(String, String, String) |
從指定的 |
| URL(String, String, Int32, String) |
由 |
| URL(String, String, Int32, String, URLStreamHandler) |
由 |
URL(String)
從表示String中建立一個URL物件。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public URL(string? spec);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.Net.URL : string -> Java.Net.URL
參數
- spec
- String
以 String 解析為 URL。
- 屬性
例外狀況
如果 spec 無法解析為 URL。
備註
從表示String中建立一個URL物件。
此建構子等價於呼叫帶有 null 第一參數的兩參數建構子。
Java 文件 java.net.URL.URL(java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
URL(URL, String)
透過解析指定上下文中的規格來建立 URL。
[Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;)V", "")]
public URL(Java.Net.URL? context, string? spec);
[<Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;)V", "")>]
new Java.Net.URL : Java.Net.URL * string -> Java.Net.URL
參數
- context
- URL
解析規範的上下文。
- spec
- String
以 String 解析為 URL。
- 屬性
例外狀況
如果 spec 無法解析為 URL,或有不支援的協定。
備註
透過解析指定上下文中的規格來建立 URL。
新網址是根據給定的上下文 URL 和 spec 參數建立的,詳見 RFC2396 ”統一資源識別碼:通用 * 語法等;: <引用>
<scheme>://<authority><path>?<query>#<fragment>
</blockquote> 引用被解析為 scheme、authority、path、query 和 fragment 部分。 如果路徑元件為空且 scheme、authority 和 query 元件未定義,則新網址即為目前文件的參考。 否則,規範中存在的片段與查詢部分會被用於新網址。
如果 scheme 元件在給定規格中被定義,且與上下文的方案不符,則新 URL 會根據規格建立為絕對 URL。 否則,scheme 元件則繼承自上下文 URL。
如果規範中存在權威成分,則規範被視為絕對,規範權威與路徑會取代上下文權威與路徑。 如果規範中缺少權威成分,則新網址的權威將從上下文繼承。
如果spec的路徑成分以斜杠開頭 “/”接著路徑被視為絕對路徑,而 spec 路徑會取代上下文路徑。
否則,路徑被視為相對路徑,並附加於上下文路徑,如RFC2396所述。 此外,在此情況下,路徑透過移除因 “ 發生而產生的目錄變更而被標準化。“以及 &&。
欲了解 URL 解析的更詳細說明,請參考 RFC2396。
Java 文件 java.net.URL.URL(java.net.URL, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
URL(URL, String, URLStreamHandler)
透過解析指定的處理器在指定上下文中,建立一個 URL。
[Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;Ljava/net/URLStreamHandler;)V", "")]
public URL(Java.Net.URL? context, string? spec, Java.Net.URLStreamHandler? handler);
[<Android.Runtime.Register(".ctor", "(Ljava/net/URL;Ljava/lang/String;Ljava/net/URLStreamHandler;)V", "")>]
new Java.Net.URL : Java.Net.URL * string * Java.Net.URLStreamHandler -> Java.Net.URL
參數
- context
- URL
解析規範的上下文。
- spec
- String
以 String 解析為 URL。
- handler
- URLStreamHandler
就是該 URL 的串流處理程序。
- 屬性
例外狀況
若無法解析該字串 spec 為 URL,或發現無效協定。
備註
透過解析指定的處理器在指定上下文中,建立一個 URL。 若處理器為空,解析過程與雙參數建構子相同。
Java 文件 java.net.URL.URL(java.net.URL, java.lang.String, java.net.URLStreamHandler)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
URL(String, String, String)
從指定的 protocol 名稱、 host 名稱和 file 名稱建立一個網址。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V", "")]
public URL(string? protocol, string? host, string? file);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V", "")>]
new Java.Net.URL : string * string * string -> Java.Net.URL
參數
- protocol
- String
使用協議名稱。
- host
- String
主持人的名字。
- file
- String
主機的檔案。
- 屬性
例外狀況
如果所有參數的組合不代表有效的 URL,或是該協定無效。
備註
從指定的 protocol 名稱、 host 名稱和 file 名稱建立一個網址。 使用指定協定的預設埠。
此方法等同於呼叫四參數構造子,其中參數分別為 protocol、 host、 -1、 file和 。
此建構子不會對輸入進行驗證。
Java 文件 java.net.URL.URL(java.lang.String, java.lang.String, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
URL(String, String, Int32, String)
由URL指定的 protocol、 host、 和 fileport 建立物件。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;)V", "")]
public URL(string? protocol, string? host, int port, string? file);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;)V", "")>]
new Java.Net.URL : string * string * int * string -> Java.Net.URL
參數
- protocol
- String
使用協議名稱。
- host
- String
主持人的名字。
- port
- Int32
主機上的埠號。
- file
- String
主機上的檔案
- 屬性
例外狀況
如果所有參數的組合不代表有效的 URL,或是該協定無效。
備註
由URL指定的 protocol、 host、 和 fileport 建立物件。
host 可以表示為主機名稱或字面上的 IP 位址。 若使用 IPv6 字面位址,應依 RFC 2732 規定以方括號'['(和']')包覆;然而,RFC 中定義的字面 IPv6 位址格式;2373:IP 版本 6 位址架構http://www.ietf.org/rfc/rfc2373.txt也被接受。
指定 port 的 -1 數字表示 URL 應使用該協定的預設埠。
若這是第一個以指定協定建立的 URL 物件,則會為該協定建立一個串流 協定處理 物件,即類別 URLStreamHandler的實例: <ol><li>若應用程式先前已將 的 URLStreamHandlerFactory 實例設定為串流處理工廠,則 createURLStreamHandler 會呼叫該實例的方法,並以協定字串作為參數來建立串流協定處理程序。
<li>如果 URLStreamHandlerFactory 尚未設定 ,或工廠 createURLStreamHandler 的方法回傳 null,則建構子會尋找系統屬性的值: <blockquote>
java.protocol.handler.pkgs
</blockquote> 如果該系統屬性的值不是 null,則會被解釋為一個以垂直斜線字元|「''分隔的套件清單。 建構子嘗試載入名為: <blockquote 的類別>
<<i>package</i>>.<<i>protocol</i>>.Handler
URLStreamHandler子類別,則嘗試列表中的下一個封包。
<li>如果前一步未能找到協定處理器,則建構子嘗試從系統預設套件載入。
<引用>
<<i>system default package</i>>.<<i>protocol</i>>.Handler
</blockquote> 如果這個類別不存在,或該類別存在但不是 的 URLStreamHandler子類別,則會拋出 a MalformedURLException 。
</ol>
以下協定的處理器必定存在於搜尋路徑上 :- <blockquote>
http, https, file, and jar
</blockquote> 協定處理程序中可能有額外協定的使用。
此建構子不會對輸入進行驗證。
Java 文件 java.net.URL.URL(java.lang.String, java.lang.String, int, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
URL(String, String, Int32, String, URLStreamHandler)
由 URL 指定的 protocol、 host、 portfile、 handler和 建立一個物件。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;Ljava/net/URLStreamHandler;)V", "")]
public URL(string? protocol, string? host, int port, string? file, Java.Net.URLStreamHandler? handler);
[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;Ljava/net/URLStreamHandler;)V", "")>]
new Java.Net.URL : string * string * int * string * Java.Net.URLStreamHandler -> Java.Net.URL
參數
- protocol
- String
使用協議名稱。
- host
- String
主持人的名字。
- port
- Int32
主機上的埠號。
- file
- String
主機上的檔案
- handler
- URLStreamHandler
就是該 URL 的串流處理程序。
- 屬性
例外狀況
如果所有參數的組合不代表有效的 URL,或是該協定無效。
備註
由 URL 指定的 protocol、 host、 portfile、 handler和 建立一個物件。 指定 port 的 -1 數字表示 URL 應使用該協定的預設埠。 指定 a handler 表示 null URL 應使用協定的預設串流處理程序,詳見:java.net.URL#URL(java.lang.String, java.lang.String, int, java.lang.String)
如果處理器不是空且有安全管理員,則會以權限呼叫NetPermission("specifyStreamHandler")安全管理員的方法checkPermission。 這可能導致安全例外。
此建構子不會對輸入進行驗證。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。