URLConnection 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
抽象類別 URLConnection 是所有代表應用程式與 URL 之間通訊連結的類別的超類別。
[Android.Runtime.Register("java/net/URLConnection", DoNotGenerateAcw=true)]
public abstract class URLConnection : Java.Lang.Object[<Android.Runtime.Register("java/net/URLConnection", DoNotGenerateAcw=true)>]
type URLConnection = class
inherit Object- 繼承
- 衍生
- 屬性
備註
抽象類別 URLConnection 是所有代表應用程式與 URL 之間通訊連結的類別的超類別。 此類別的實例可用於讀取或寫入 URL 所參考的資源。 一般而言，建立 URL 連線是一個多步驟的過程：
<中心><表格邊框=2 摘要=「描述建立與 URL 連線的過程：openConnection（） 與 connect（） 隨時間推移。」><tr><th>openConnection()</th th><>/thconnect()</tr><>< tr td><>操作影響遠端資源連線的參數。</td><td>與資源互動;查詢標頭欄位與內容。</td></tr></表格> ----------------------------> <BR>時間</中心>
<ol><li>連接物件是透過在 URL 上呼叫該 openConnection 方法來建立的。
<LI>設定參數與一般請求屬性會被調整。
<li>實際與遠端物件的連結是透過 方法 connect 建立的。
<li>遠端物件變得可用。 遠端物件的標頭欄位與內容皆可被存取。
</ol>
設定參數會透過以下方法進行修改：<ul><li>setAllowUserInteraction<li>setDoInput<>setDoOutput<>setIfModifiedSince<>setUseCaches</ul>
一般請求屬性則透過以下方法進行修改： <ul><li>setRequestProperty</ul>
和參數的預設值AllowUserInteractionUseCaches可用 和 setDefaultAllowUserInteraction方法設定setDefaultUseCaches。
上述 set 每種方法都有相應 get 的方法來取得參數值或一般請求屬性。 適用的特定參數與一般請求屬性則依協定而定。
連接遠端物件後，使用以下方法存取標頭欄位及內容：<ul><li>getContent<li>getHeaderField<>getInputStream<>getOutputStream</ul>
某些標頭欄位會被頻繁存取。 方法：<ul><li>getContentEncoding<li>getContentLength<li li>getContentType<>getDate<li>getExpiration<li>getLastModifed</ul>
提供方便的田徑存取。 方法用getContentType此getContent方法來判定遠端物件的類型;子類別可能會覺得覆寫此getContentType方法很方便。
在常見情況下，所有連線前參數與一般請求屬性都可以忽略：連線前參數與請求屬性預設為合理的值。 對於大多數此介面的用戶端，只有兩種有趣的方法： getInputStream 和 getContent，這些方法在類別中會被便利方法鏡 URL 像。
關於連線的請求屬性與標頭欄位 http 的更多資訊，請參見： <blockquote>
<a href="http://www.ietf.org/rfc/rfc2616.txt">http://www.ietf.org/rfc/rfc2616.txt</a>
</區塊引用>
在 close()InputStreamOutputStreamURLConnection 請求後呼叫 或 的方法可能會釋放與此實例相關的網路資源，除非特定協定規範對其行為有不同要求。
新增於JDK1.0。
Java 文件 java.net.URLConnection。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| URLConnection(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
| URLConnection(URL) |
建立與指定 URL 的連結。 |
屬性
| 名稱 | Description |
|---|---|
| AllowUserInteraction |
回傳該物件欄位的 |
| Class |
回傳此 |
| Connected |
若 |
| ConnectTimeout |
回傳連線逾時設定。 -或- 設定一個指定的逾時值，單位為毫秒，用於開啟此 URLConnection 所參考資源的通訊連結。 |
| Content |
擷取此 URL 連線的內容。 |
| ContentEncoding |
回傳標頭欄位的 |
| ContentLength |
回傳標頭欄位的 |
| ContentLengthLong |
回傳標頭欄位的值 |
| ContentType |
回傳標頭欄位的 |
| Date |
回傳標頭欄位的 |
| DefaultAllowUserInteraction |
回傳欄位的 |
| DefaultUseCaches |
回傳 的預設值 |
| DoInput |
回傳此 |
| DoOutput |
回傳此 |
| Expiration |
回傳標頭欄位的 |
| FileNameMap |
回傳 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| HeaderFields |
回傳一個不可修改的標頭欄位映射。 |
| IfModifiedSince |
回傳該物件 |
| InputStream |
回傳一個從此開放連接讀取的輸入串流。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
抽象類別 |
| JniPeerMembers |
抽象類別 |
| LastModified |
回傳標頭欄位的 |
| OutputStream |
回傳一個寫入此連線的輸出串流。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| Permission |
回傳一個權限物件，代表建立該物件所代表連線所需的權限。 |
| ReadTimeout |
回傳設定以進行讀取逾時。 -或- 將讀取逾時設定為指定的逾時，單位為毫秒。 |
| RequestProperties |
回傳一個不可修改的一般請求屬性映射。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| Url |
該網址代表此連線所開啟的萬維網上遠端物件。 |
| URL |
回傳此 |
| UseCaches |
回傳此 |
方法
| 名稱 | Description |
|---|---|
| AddRequestProperty(String, String) |
新增由鍵值對指定的一般請求屬性。 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Connect() |
若尚未建立該連結，將開啟指向該 URL 所引用資源的通訊連結。 |
| ConnectAsync() |
抽象類別 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
抽象類別 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
抽象類別 |
| Equals(Object) |
抽象類別 |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetContent(Class[]) |
擷取此 URL 連線的內容。 |
| GetDefaultRequestProperty(String) |
已淘汰.
回傳預設請求屬性的值。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetHeaderField(Int32) |
回傳 sup |
| GetHeaderField(String) |
回傳命名標頭欄位的值。 |
| GetHeaderFieldDate(String, Int64) |
回傳解析為日期的命名欄位值。 |
| GetHeaderFieldInt(String, Int32) |
回傳解析為數字後命名欄位的值。 |
| GetHeaderFieldKey(Int32) |
回傳 sup th/sup |
| GetHeaderFieldLong(String, Int64) |
回傳解析為數字後命名欄位的值。 |
| GetRequestProperty(String) |
回傳此連線所命名的一般請求屬性的值。 |
| GuessContentTypeFromName(String) |
嘗試根據 URL 中指定的「檔案」成分來判斷物件的內容類型。 |
| GuessContentTypeFromStream(Stream) |
嘗試根據輸入串流開頭的字元來判斷輸入串流的類型。 |
| JavaFinalize() |
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| SetContentHandlerFactory(IContentHandlerFactory) |
設定應用程式的 。 |
| SetDefaultRequestProperty(String, String) |
已淘汰.
設定一般請求屬性的預設值。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
抽象類別 |
| SetRequestProperty(String, String) |
設定一般請求屬性。 |
| 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() |
抽象類別 |
| IJavaPeerable.Finalized() |
抽象類別 |
| IJavaPeerable.JniObjectReferenceControlBlock |
抽象類別 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
抽象類別 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
抽象類別 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
抽象類別 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
抽象類別 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |