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 的連線是多步驟程式：
<center><table border=2 summary=“描述建立 URL 連線的程式：openConnection（） 和 connect（） 一段時間。><tr><th><openConnection()/th><>connect()</th></tr><tr><td>操作影響遠端資源連線的參數。</td td><>與資源互動;查詢標頭字段和內容。</td></tr></table> ----------------------------> <br>time</center>
<ol><li>藉由叫用 openConnection URL 上的 方法來建立連接物件。 <li>會操作安裝程序參數和一般要求屬性。 <li>使用 connect 方法建立與遠端物件的實際連線。 <li>遠端物件可供使用。 可以存取遠端物件的標頭欄位和內容。 </老>
使用下列方法修改設定參數：<ul><lisetAllowUserInteraction<>li<setDoInput>li li><setDoOutput/ul>setIfModifiedSince<>setUseCaches<>
和 一般要求屬性是使用 方法修改的： <ul><li>setRequestProperty</ul>
和 UseCaches 參數的AllowUserInteraction預設值可以使用 方法和 setDefaultAllowUserInteraction setDefaultUseCaches來設定。
上述 set 每個方法都有對應的 get 方法來擷取參數或一般要求屬性的值。 適用的特定參數和一般要求屬性為特定通訊協定。
下列方法可用來存取對遠端物件建立連接之後的標頭字段和內容：<ul<>li<>getContentli<>getHeaderFieldli<>getInputStream/ul>getOutputStream<>
經常存取特定標頭欄位。 方法：<ul><ligetDategetContentLength<getContentEncoding>><><><getContentTypeli<getLastModifedgetExpiration><>/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>
</blockquote>
close() InputStream除非特定通訊協定規格指定不同的行為，否則在要求之後叫用 或 OutputStream URLConnection 的方法可能會釋放與此實例相關聯的網路資源。
已在 JDK1.0 中新增。
的 java.net.URLConnectionJava 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| URLConnection(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
| URLConnection(URL) |
建構與指定URL的URL連線。 |
屬性
| AllowUserInteraction |
傳回這個物件的域值 |
| Class |
傳回這個 |
| Connected |
如果 |
| ConnectTimeout |
傳回聯機逾時的設定。 -或- 設定開啟此 URLConnection 所參考資源的通訊連結時所要使用的指定逾時值，以毫秒為單位。 |
| Content |
擷取此 URL 連線的內容。 |
| ContentEncoding |
傳回標頭欄位的值 |
| ContentLength |
傳回標頭欄位的值 |
| ContentLengthLong |
以 long 傳回標頭欄位的值 |
| ContentType |
傳回標頭欄位的值 |
| Date |
傳回標頭欄位的值 |
| DefaultAllowUserInteraction |
傳回欄位的 |
| DefaultUseCaches |
傳回的 |
| DoInput |
傳回這個 |
| DoOutput |
傳回這個 |
| Expiration |
傳回標頭欄位的值 |
| FileNameMap |
傳 |
| Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
| HeaderFields |
會傳回標頭欄位的不可修改對應。 |
| IfModifiedSince |
傳回這個物件的 |
| InputStream |
傳回從這個開啟的連接讀取的輸入數據流。 |
| JniIdentityHashCode |
抽象類 |
| JniPeerMembers |
抽象類 |
| LastModified |
傳回標頭欄位的值 |
| OutputStream |
傳回寫入此連接的輸出數據流。 |
| PeerReference |
抽象類 |
| Permission |
傳回許可權物件，表示建立這個物件所表示之連接所需的許可權。 |
| ReadTimeout |
傳回讀取逾時的設定。 -或- 將讀取逾時設定為指定的逾時，以毫秒為單位。 |
| RequestProperties |
傳回此連線之一般要求屬性的不可修改對應。 |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| Url |
URL 代表開啟此連線之 World Wide Web 上的遠端物件。 |
| URL |
傳回這個 |
| UseCaches |
傳回這個 |
方法
| AddRequestProperty(String, String) |
加入索引鍵/值組所指定的一般要求屬性。 |
| Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
| Connect() |
如果尚未建立這類連線，請開啟此 URL 所參考資源的通訊連結。 |
| ConnectAsync() |
抽象類 |
| Dispose() |
抽象類 |
| Dispose(Boolean) |
抽象類 |
| Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
| GetContent(Class[]) |
擷取此 URL 連線的內容。 |
| GetDefaultRequestProperty(String) |
已淘汰.
傳回預設要求屬性的值。 |
| GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
| GetHeaderField(Int32) |
傳回 sup th/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) |
| SetRequestProperty(String, String) |
設定一般要求屬性。 |
| ToArray<T>() |
抽象類 |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
抽象類 |
| Wait() |
讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object) |
| Wait(Int64, Int32) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
| Wait(Int64) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
明確介面實作
| IJavaPeerable.Disposed() |
抽象類 |
| IJavaPeerable.DisposeUnlessReferenced() |
抽象類 |
| IJavaPeerable.Finalized() |
抽象類 |
| IJavaPeerable.JniManagedPeerState |
抽象類 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
抽象類 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
抽象類 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
抽象類 |
擴充方法
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
抽象類 |
| GetJniTypeName(IJavaPeerable) |
抽象類 |