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 () and connect () 随时间推移。><tr><th><openConnection()/th><<connect()>/th></tr<><>td>操作影响与远程资源的连接的参数。</td><td>与资源交互;查询标头字段和内容。</td></tr></table> ----------------------------> <br>time</center>
<ol><li>连接对象是通过在 URL 上调用 openConnection 方法创建的。 <li>操作设置参数和常规请求属性。 <li>使用 方法与远程对象建立 connect 实际连接。 <li>远程对象变为可用。 可以访问远程对象的标头字段和内容。 </老>
使用以下方法修改设置参数：<ul><li><setAllowUserInteractionlisetDoInput><li><setDoOutputlisetIfModifiedSince<><>setUseCaches/ul>
使用 方法修改常规请求属性： <ul><li>setRequestProperty</ul>
可以使用 方法和 setDefaultAllowUserInteractionsetDefaultUseCaches设置 和 UseCaches 参数的默认值AllowUserInteraction。
上述 set 每个方法都有相应的 get 方法来检索参数或常规请求属性的值。 适用的特定参数和常规请求属性是特定于协议的。
以下方法用于在与远程对象建立连接后访问标头字段和内容：<ul><li>getContent<li><getHeaderFieldligetInputStream<><>getOutputStream/ul>
某些标头字段经常被访问。 方法：<ul><li><getContentEncodingligetContentLength><ligetContentType><li ligetDate><li li><getExpiration<>getLastModifed li/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() 或 OutputStream 的方法InputStreamURLConnection可能会释放与此实例关联的网络资源，除非特定的协议规范为其指定了不同的行为。
在 JDK1.0 中添加。
的 java.net.URLConnectionJava 文档。
此页面的部分内容是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的术语使用。
构造函数
| URLConnection(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
| 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 支持 Mono for Android 基础结构，不应直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不应直接从代码使用。 |
| Url |
URL 表示万维网上打开此连接的远程对象。 |
| 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 <通知/em> 或 <em>interrupted</em>。<> (继承自 Object) |
| Wait(Int64) |
导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object) |
| Wait(Int64, Int32) |
导致当前线程等待，直到它被唤醒，通常是通过 em <通知/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) |
抽象类 |