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 連線是一個多步驟的過程:
<中心><表格 border=2 summary=“描述建立 URL 連線的過程:openConnection() 和 connect() 隨時間進行。”><tr><thopenConnection()></th<>th><connect()/th></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 |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| LastModified |
回傳標頭欄位的 |
| OutputStream |
回傳一個寫入此連線的輸出串流。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| Permission |
回傳一個權限物件,代表建立該物件所代表連線所需的權限。 |
| ReadTimeout |
回傳設定以進行讀取逾時。 -或- 將讀取逾時設定為指定的逾時,單位為毫秒。 |
| RequestProperties |
回傳一個不可修改的一般請求屬性映射。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| Url |
該網址代表此連線所開啟的萬維網上遠端物件。 |
| URL |
回傳此 |
| UseCaches |
回傳此 |
方法
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |