JarURLConnection 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。
[Android.Runtime.Register("java/net/JarURLConnection", DoNotGenerateAcw=true)]
public abstract class JarURLConnection : Java.Net.URLConnection[<Android.Runtime.Register("java/net/JarURLConnection", DoNotGenerateAcw=true)>]
type JarURLConnection = class
inherit URLConnection- 繼承
- 屬性
備註
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。
JAR URL 的語法如下：
jar:<url>!/{entry}
比如：
jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class
jar URL 應用於指稱 JAR 檔案或其檔案中的條目。 上述範例是一個 JAR URL，指向一個 JAR 條目。 若省略條目名稱，該網址指的是整個 JAR 檔案：
jar:http://www.foo.com/bar/baz.jar!/
使用者在知道自己建立的 URL 是 JAR URL，且需要 JAR 專屬功能時，應將通用 URLConnection 轉換成 JarURLConnection。 例如：
URL url = new URL("jar:file:/home/duke/duke.jar!/");
JarURLConnection jarConnection = (JarURLConnection)url.openConnection();
Manifest manifest = jarConnection.getManifest();
JarURLConnection 實例只能用來讀取 JAR 檔案。 使用此類別無法讓 修改 java.io.OutputStream 或寫入底層的 JAR 檔案。
範例：
<DL>
<dt>A Jar entry <dd>jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class<dt>A Jar file <dd>jar:http://www.foo.com/bar/baz.jar!/<dt>A Jar 目錄 <dd>jar:http://www.foo.com/bar/baz.jar!/COM/foo/</dl>
!/ 稱為 <電磁分離器（EM>Separator</EM>）。
當透過 建構 JAR URL new URL(context, spec)時，適用以下規則：
<UL>
< >如果沒有上下文 URL，且傳遞給 URL 建構器的規格中沒有分隔符，該 URL 被視為指向 JarFile。
< >如果有上下文 URL，則假設上下文 URL 指向 JAR 檔案或 Jar 目錄。
< >如果規範以 '/' 開頭，則忽略 Jar 目錄，該規範被視為 Jar 檔案的根節點。
範例：
<DL>
<DT>背景： <B>jar：http://www.foo.com/bar/jar.jar！/</b，spec>：<b>baz/entry.txt</b>
<dd>網址：<b>jar：http://www.foo.com/bar/jar.jar！/baz/entry.txt</b>
<DT>背景： <B>jar：http://www.foo.com/bar/jar.jar！/baz</b，spec>：<b>entry.txt</b>
<dd>網址：<b>jar：http://www.foo.com/bar/jar.jar！/baz/entry.txt</b>
<DT>背景： <B>jar：http://www.foo.com/bar/jar.jar！/baz</b，spec>：<b>/entry.txt</b>
<dd>網址：<b>jar：http://www.foo.com/bar/jar.jar！/entry.txt</b>
</dl>
</ul>
在 1.2 版本中加入。
Java 文件 java.net.JarURLConnection。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| JarURLConnection(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
| JarURLConnection(URL) |
建立新的 JarURLConnection 到指定的網址。 |
屬性
| 名稱 | Description |
|---|---|
| AllowUserInteraction |
回傳該物件欄位的 |
| Attributes |
如果該連線的 URL 指向 JAR 檔案條目，則回傳 Attributes 物件，否則為 null。 |
| Class |
回傳此 |
| Connected |
若 |
| ConnectTimeout |
回傳連線逾時設定。 -或- 設定一個指定的逾時值，單位為毫秒，用於開啟此 URLConnection 所參考資源的通訊連結。 (繼承來源 URLConnection) |
| Content |
擷取此 URL 連線的內容。 (繼承來源 URLConnection) |
| ContentEncoding |
回傳標頭欄位的 |
| ContentLength |
回傳標頭欄位的 |
| ContentLengthLong |
回傳標頭欄位的值 |
| ContentType |
回傳標頭欄位的 |
| Date |
回傳標頭欄位的 |
| DefaultUseCaches |
回傳 的預設值 |
| DoInput |
回傳此 |
| DoOutput |
回傳此 |
| EntryName |
回傳此連線的條目名稱。 |
| Expiration |
回傳標頭欄位的 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| HeaderFields |
回傳一個不可修改的標頭欄位映射。 (繼承來源 URLConnection) |
| IfModifiedSince |
回傳該物件 |
| InputStream |
回傳一個從此開放連接讀取的輸入串流。 (繼承來源 URLConnection) |
| JarEntry |
回傳此連線的 JAR 入口物件（若有的話）。 |
| JarFile |
取得 |
| JarFileURL |
回傳此連線 Jar 檔案的 URL。 |
| JarFileURLConnection |
連線到 JAR 檔案的 URL（如果連線已啟動）。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| JniPeerMembers |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 |
| LastModified |
回傳標頭欄位的 |
| MainAttributes |
回傳此連線 JAR 檔案的主要屬性。 |
| Manifest |
回傳此連線的 Manifest，若無則為 null。 |
| OutputStream |
回傳一個寫入此連線的輸出串流。 (繼承來源 URLConnection) |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| Permission |
回傳一個權限物件，代表建立該物件所代表連線所需的權限。 (繼承來源 URLConnection) |
| ReadTimeout |
回傳設定以進行讀取逾時。 -或- 將讀取逾時設定為指定的逾時，單位為毫秒。 (繼承來源 URLConnection) |
| RequestProperties |
回傳一個不可修改的一般請求屬性映射。 (繼承來源 URLConnection) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| Url |
該網址代表此連線所開啟的萬維網上遠端物件。 (繼承來源 URLConnection) |
| URL |
回傳此 |
| UseCaches |
回傳此 |
方法
| 名稱 | Description |
|---|---|
| AddRequestProperty(String, String) |
新增由鍵值對指定的一般請求屬性。 (繼承來源 URLConnection) |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Connect() |
若尚未建立該連結，將開啟指向該 URL 所引用資源的通訊連結。 (繼承來源 URLConnection) |
| ConnectAsync() |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 URLConnection) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| Equals(Object) |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetCertificates() |
如果該連線的 URL 指向 JAR 檔案條目，則回傳該連線的憑證物件，否則為 null。 |
| GetContent(Class[]) |
擷取此 URL 連線的內容。 (繼承來源 URLConnection) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetHeaderField(Int32) |
回傳 sup |
| GetHeaderField(String) |
回傳命名標頭欄位的值。 (繼承來源 URLConnection) |
| GetHeaderFieldDate(String, Int64) |
回傳解析為日期的命名欄位值。 (繼承來源 URLConnection) |
| GetHeaderFieldInt(String, Int32) |
回傳解析為數字後命名欄位的值。 (繼承來源 URLConnection) |
| GetHeaderFieldKey(Int32) |
回傳 sup th/sup |
| GetHeaderFieldLong(String, Int64) |
回傳解析為數字後命名欄位的值。 (繼承來源 URLConnection) |
| GetRequestProperty(String) |
回傳此連線所命名的一般請求屬性的值。 (繼承來源 URLConnection) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| SetRequestProperty(String, String) |
設定一般請求屬性。 (繼承來源 URLConnection) |
| 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() |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
一個 URL 連線到 Java ARchive（JAR）檔案，或是 JAR 檔案中的一個項目。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |