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 () 和連接 () 一段時間。」><tr><th<<connect()
>>openConnection()
/><th/th></tr><><td>操作影響遠端資源連線的參數。</td td><>與資源互動;查詢標頭字段和內容。</td></tr></table> ----------------------------> <br>time</center>
<ol li>藉><由叫openConnection
用 URL 上的 方法來建立連接物件。 <li>會操作安裝程序參數和一般要求屬性。 <li>使用 connect
方法建立與遠端物件的實際連線。 <li>遠端物件變成可用。 您可以存取遠端物件的標頭欄位和內容。 </老>
安裝程序參數是使用下列方法來修改:<ul><<setAllowUserInteraction
>li>setDoInput
<li li>setDoOutput
<li<setUseCaches
setIfModifiedSince
><>/ul>
和 一般要求屬性是使用 方法來修改: <ul><li>setRequestProperty
</ul>
和 UseCaches
參數的AllowUserInteraction
預設值可以使用 方法和 setDefaultAllowUserInteraction
setDefaultUseCaches
來設定。
上述 set
每個方法都有對應的 get
方法來擷取參數或一般要求屬性的值。 適用的特定參數和一般要求屬性都是特定通訊協定。
下列方法可用來存取連接遠端物件之後的標頭字段和內容:<ul><li<>getContent
li>getHeaderField
<li li<getOutputStream
getInputStream
><>/ul>
某些標頭欄位經常存取。 方法:<ulgetContentEncoding
getContentLength
<>><><li li>getContentType
<li li>getDate
<li<getLastModifed
getExpiration
><>/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.URLConnection
Java 檔。
此頁面的部分是根據 所建立和共用的工作進行修改,並根據 2.5 屬性授權中所述的詞彙來使用。
建構函式
URLConnection(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時所使用的建構函式;由運行時間呼叫。 |
URLConnection(URL) |
建構與指定URL的URL連線。 |
屬性
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 |
抽象類 |
JniPeerMembers |
抽象類 |
LastModified |
傳回標頭欄位的值 |
OutputStream |
傳回寫入此連接的輸出數據流。 |
PeerReference |
抽象類 |
Permission |
會傳回許可權物件,此物件代表建立這個物件所代表之連接所需的許可權。 |
ReadTimeout |
傳回讀取逾時的設定。 -或- 將讀取逾時設定為指定的逾時,以毫秒為單位。 |
RequestProperties |
傳回此連線之一般要求屬性的不可修改對應。 |
ThresholdClass |
此 API 支援 Mono for Android 基礎結構,並不適合直接從您的程式代碼使用。 |
ThresholdType |
此 API 支援 Mono for Android 基礎結構,並不適合直接從您的程式代碼使用。 |
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) |
讓目前的線程等到喚醒為止,通常是<透過em>notified</em或em>interrupted</em>>,或<直到經過一定數量的實時為止。 (繼承來源 Object) |
Wait(Int64, Int32) |
讓目前的線程等到喚醒為止,通常是<透過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) |
抽象類 |