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=“Describes the process of creating a connection to a URL： openConnection（） and connect（） over time.><tr><th><openConnection()/><connect()><th/th></tr><td><>操作影响与远程资源的连接的参数。</td td><>与资源交互;查询标头字段和内容。</td></tr></table> ----------------------------> <br>time</center>
<ol><li>连接对象是通过 openConnection 调用 URL 上的方法创建的。 <li>操作设置参数和常规请求属性。 <li>使用 connect 此方法建立与远程对象的实际连接。 <li>远程对象变为可用。 可以访问远程对象的标头字段和内容。 </老>
设置参数使用以下方法进行修改：<ul><li>setAllowUserInteraction<li lisetDoInput<>li li<setDoOutput>/ul>setIfModifiedSince<>setUseCaches<>
使用方法修改常规请求属性： <ul><li>setRequestProperty</ul>
可以使用方法和setDefaultAllowUserInteraction参数设置默认值UseCachesAllowUserInteraction。setDefaultUseCaches
上述 set 每个方法都有相应的 get 方法来检索参数或常规请求属性的值。 适用的特定参数和常规请求属性特定于协议。
以下方法用于在与远程对象建立连接后访问标头字段和内容：<ul><li<>getContentligetHeaderField><li ligetInputStream<><>getOutputStream/ul>
经常访问某些标头字段。 方法：ul>li ligetContentEncoding<<>>getContentLengthli>getContentType<li li><getDateli li><<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 对象的托管表示形式时使用的构造函数;由运行时调用。 |
| URLConnection(URL) |
构造与指定 URL 的 URL 连接。 |
属性
| AllowUserInteraction |
返回此对象的字段的值 |
| Class |
返回此 |
| Connected |
如果 |
| ConnectTimeout |
返回连接超时的设置。 - 或 - 设置指定超时值（以毫秒为单位），用于打开此 URLConnection 引用的资源的通信链接。 |
| Content |
检索此 URL 连接的内容。 |
| ContentEncoding |
返回标头字段的值 |
| ContentLength |
返回标头字段的值 |
| ContentLengthLong |
将标头字段的值 |
| ContentType |
返回标头字段的值 |
| Date |
返回标头字段的值 |
| DefaultAllowUserInteraction |
返回字段的 |
| DefaultUseCaches |
返回 's |
| 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, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <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) |
抽象类 |