URLConnection 类

定义

命名空间:

Java.Net

程序集:

Mono.Android.dll

抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。

[Android.Runtime.Register("java/net/URLConnection", DoNotGenerateAcw=true)]
public abstract class URLConnection : Java.Lang.Object

继承

Object

Object

URLConnection

派生

Java.Net.HttpURLConnection

Java.Net.JarURLConnection

属性

RegisterAttribute

注解

抽象类 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	返回此对象的字段的值 allowUserInteraction 。 - 或 - 设置此URLConnection字段的值allowUserInteraction。
Class	返回此 Object的运行时类。 (继承自 Object)
Connected	如果 false，此连接对象尚未创建指向指定 URL 的通信链接。
ConnectTimeout	返回连接超时的设置。 - 或 - 设置指定超时值（以毫秒为单位），用于打开此 URLConnection 引用的资源的通信链接。
Content	检索此 URL 连接的内容。
ContentEncoding	返回标头字段的值 content-encoding 。
ContentLength	返回标头字段的值 content-length 。
ContentLengthLong	将标头字段的值 content-length 返回为长。
ContentType	返回标头字段的值 content-type 。
Date	返回标头字段的值 date 。
DefaultAllowUserInteraction	返回字段的 allowUserInteraction 默认值。 - 或 - 将所有未来URLConnection对象的字段默认值allowUserInteraction设置为指定值。
DefaultUseCaches	返回 's useCaches 标志的URLConnection默认值。 - 或 - 将字段的 useCaches 默认值设置为指定值。
DoInput	返回此 URLConnection标志 doInput 的值。 - 或 - 将字段URLConnection的值doInput设置为指定值。
DoOutput	返回此 URLConnection标志 doOutput 的值。 - 或 - 将字段URLConnection的值doOutput设置为指定值。
Expiration	返回标头字段的值 expires 。
FileNameMap	返回一个 FileNameMap 实现，该实现适合根据 URL 的“文件”组件猜测内容类型。 - 或 - 设置 FileNameMap。
Handle	基础 Android 实例的句柄。 (继承自 Object)
HeaderFields	返回标头字段的不可修改的映射。
IfModifiedSince	返回此对象的 ifModifiedSince 字段的值。 - 或 - 将此URLConnection字段的值ifModifiedSince设置为指定值。
InputStream	返回从此打开的连接中读取的输入流。
JniIdentityHashCode	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
JniPeerMembers	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。
LastModified	返回标头字段的值 last-modified 。
OutputStream	返回写入此连接的输出流。
PeerReference	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
Permission	返回一个权限对象，该对象表示建立由此对象表示的连接所需的权限。
ReadTimeout	返回读取超时的设置。 - 或 - 将读取超时设置为指定的超时，以毫秒为单位。
RequestProperties	返回此连接的常规请求属性的不可修改映射。
ThresholdClass	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。
ThresholdType	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。
Url	URL 表示打开此连接的万维网上的远程对象。
URL	返回此 URLConnection字段 URL 的值。
UseCaches	返回此 URLConnection字段 useCaches 的值。 - 或 - 将此URLConnection字段的值useCaches设置为指定值。

方法

AddRequestProperty(String, String)	添加由键值对指定的常规请求属性。
Clone()	创建并返回此对象的副本。 (继承自 Object)
Connect()	打开此 URL 引用的资源的通信链接（如果尚未建立此类连接）。
ConnectAsync()	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。
Dispose()	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
Dispose(Boolean)	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
Equals(Object)	指示其他对象是否“等于”此对象。 (继承自 Object)
GetContent(Class[])	检索此 URL 连接的内容。
GetDefaultRequestProperty(String)	已过时. 返回默认请求属性的值。
GetHashCode()	返回对象的哈希代码值。 (继承自 Object)
GetHeaderField(Int32)	返回 sup th/sup> 标头字段的值n<。<>
GetHeaderField(String)	返回命名标头字段的值。
GetHeaderFieldDate(String, Int64)	返回被分析为日期的命名字段的值。
GetHeaderFieldInt(String, Int32)	返回被分析为数字的命名字段的值。
GetHeaderFieldKey(Int32)	返回 sup>th</sup> 标头字段的n<键。
GetHeaderFieldLong(String, Int64)	返回被分析为数字的命名字段的值。
GetRequestProperty(String)	返回此连接的命名常规请求属性的值。
GuessContentTypeFromName(String)	尝试根据 URL 的指定“文件”组件确定对象的内容类型。
GuessContentTypeFromStream(Stream)	尝试根据输入流开头的字符确定输入流的类型。
JavaFinalize()	当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object)
Notify()	唤醒正在等待此对象的监视器的单个线程。 (继承自 Object)
NotifyAll()	唤醒正在等待此对象的监视器的所有线程。 (继承自 Object)
SetContentHandlerFactory(IContentHandlerFactory)	ContentHandlerFactory设置应用程序。
SetDefaultRequestProperty(String, String)	已过时. 设置常规请求属性的默认值。
SetHandle(IntPtr, JniHandleOwnership)	设置 Handle 属性。 (继承自 Object)
SetRequestProperty(String, String)	设置常规请求属性。
ToArray<T>()	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
ToString()	返回对象的字符串表示形式。 (继承自 Object)
UnregisterFromRuntime()	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
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()	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
IJavaPeerable.Finalized()	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
IJavaPeerable.JniManagedPeerState	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。 (继承自 Object)

扩展方法

JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。
GetJniTypeName(IJavaPeerable)	抽象类 URLConnection 是表示应用程序与 URL 之间的通信链接的所有类的超级类。

适用于