URLConnection Класс

Определение

Пространство имен:: Java.Net

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Абстрактный класс 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

Наследование: Object

JavaObject

Object
URLConnection

Производный: Java.Net.HttpURLConnection

Java.Net.JarURLConnection

Атрибуты: RegisterAttribute

Абстрактный класс URLConnection — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. Экземпляры этого класса можно использовать как для чтения, так и для записи в ресурс, на который ссылается URL-адрес. Как правило, создание подключения к URL-адресу — это многоэтапный процесс:

<Граница таблицы центра><=2 сводка="Описывает процесс создания подключения к URL-адресу: openConnection() и connect() с течением времени".><tr><>openConnection()< th/th/><th>connect()<></th/tr tr><><td>Управление параметрами, влияющими на подключение к удаленному ресурсу.</td td><>interact with the resource; поля заголовка запроса и содержимое.</td></tr></table> ----------------------------> <br>time</center>

<ol><li>Объект подключения создается путем вызова openConnection метода по URL-адресу. <li>Параметры установки и общие свойства запроса обрабатываются. <li>Фактическое подключение к удаленному объекту connect выполняется с помощью метода. <li>Удаленный объект становится доступным. К полям заголовка и содержимому удаленного объекта можно получить доступ. </Пр>

Параметры установки изменяются с помощью следующих методов: <ul><li>setAllowUserInteraction<li li>setDoInput<>setDoOutput<li li li>setIfModifiedSince</ul>setUseCaches<>

и общие свойства запроса изменяются с помощью метода: <ul li><>/ulsetRequestProperty<>

Значения по умолчанию для AllowUserInteraction параметров можно UseCaches задать с помощью методов setDefaultAllowUserInteraction и setDefaultUseCaches.

Каждый из указанных выше set методов имеет соответствующий get метод для получения значения параметра или свойства общего запроса. Конкретные параметры и общие свойства запроса, применимые к протоколу.

Следующие методы используются для доступа к полям заголовка и содержимому после подключения к удаленному объекту: <ul><li li>getContent<li>getHeaderField<li>getInputStream<>getOutputStream</ul>

К определенным полям заголовка часто обращаются. Методы: <ul><li>getContentEncoding<>getContentLength<>getContentType<>getDate</ul>getExpiration<>getLastModifed<>

предоставляет удобный доступ к этим полям. Метод 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() методов или InputStreamOutputStreamURLConnection после запроса может освободить сетевые ресурсы, связанные с этим экземпляром, если для этого экземпляра не указаны определенные спецификации протокола.

Добавлено в JDK1.0.

Java документации по java.net.URLConnection.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Конструкторы

Имя	Описание
URLConnection(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.
URLConnection(URL)	Создает подключение URL-адреса к указанному URL-адресу.

Свойства

Имя	Описание
AllowUserInteraction	Возвращает значение `allowUserInteraction` поля для этого объекта. -или- Задайте значение `allowUserInteraction` поля этого `URLConnection`поля.
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` по умолчанию поля. -или- Задает значение `allowUserInteraction` поля по умолчанию для всех будущих `URLConnection` объектов указанным значением.
DefaultUseCaches	Возвращает значение по умолчанию флага`URLConnectionuseCaches`. -или- Задает значение `useCaches` по умолчанию поля в указанное значение.
DoInput	Возвращает значение этого `URLConnection`флага `doInput` . -или- задает значение `doInput` поля для этого `URLConnection` значения в указанное значение.
DoOutput	Возвращает значение этого `URLConnection`флага `doOutput` . -или- задает значение `doOutput` поля для этого `URLConnection` значения в указанное значение.
Expiration	Возвращает значение поля заголовка `expires` .
FileNameMap	Возвращает реализацию, подходящую `FileNameMap` для угадывание типа контента на основе компонента URL-адреса "file". -или— задает fileNameMap.
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
HeaderFields	Возвращает неизменяемую карту полей заголовка.
IfModifiedSince	Возвращает значение поля этого объекта `ifModifiedSince` . -или- Задает значение `ifModifiedSince` поля этого `URLConnection` значения заданному значению.
InputStream	Возвращает входной поток, который считывается из этого открытого подключения.
JniIdentityHashCode	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
JniPeerMembers	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом.
LastModified	Возвращает значение поля заголовка `last-modified` .
OutputStream	Возвращает выходной поток, записываемый в это соединение.
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
Permission	Возвращает объект разрешения, представляющий разрешение, необходимое для подключения, представленного этим объектом.
ReadTimeout	Возвращает параметр времени ожидания чтения. -или- Задает время ожидания чтения для указанного времени ожидания в миллисекундах.
RequestProperties	Возвращает неизменяемую карту общих свойств запроса для этого соединения.
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
Url	URL-адрес представляет удаленный объект в World Wide Web, к которому открывается это подключение.
URL	Возвращает значение этого `URLConnectionURL` поля.
UseCaches	Возвращает значение этого `URLConnectionuseCaches` поля. -или- Задает значение `useCaches` поля этого `URLConnection` значения заданному значению.

Методы

Имя	Описание
AddRequestProperty(String, String)	Добавляет общее свойство запроса, указанное парой "ключ-значение".
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
Connect()	Открывает ссылку на связь с ресурсом, на который ссылается этот URL-адрес, если такое подключение еще не установлено.
ConnectAsync()	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом.
Construct(JniObjectReference, JniObjectReferenceOptions)	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
Equals(Object)	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
GetContent(Class[])	Извлекает содержимое этого URL-подключения.
GetDefaultRequestProperty(String)	Устаревшие. Возвращает значение свойства запроса по умолчанию.
GetHashCode()	Возвращает хэш-значение кода для объекта. (Унаследовано от Object)
GetHeaderField(Int32)	Возвращает значение для поля заголовка `n`<sup>th</sup> .
GetHeaderField(String)	Возвращает значение именованного поля заголовка.
GetHeaderFieldDate(String, Int64)	Возвращает значение именованного поля, проанализированного как дата.
GetHeaderFieldInt(String, Int32)	Возвращает значение именованного поля, проанализированного как число.
GetHeaderFieldKey(Int32)	Возвращает ключ для поля заголовка `n`<sup>th</sup> .
GetHeaderFieldLong(String, Int64)	Возвращает значение именованного поля, проанализированного как число.
GetRequestProperty(String)	Возвращает значение именованного свойства общего запроса для этого соединения.
GuessContentTypeFromName(String)	Пытается определить тип контента объекта на основе указанного компонента "file" URL-адреса.
GuessContentTypeFromStream(Stream)	Пытается определить тип входного потока на основе символов в начале входного потока.
JavaFinalize()	Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object)
Notify()	Просыпается один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object)
SetContentHandlerFactory(IContentHandlerFactory)	`ContentHandlerFactory` Задает приложение.
SetDefaultRequestProperty(String, String)	Устаревшие. Задает значение по умолчанию свойства общего запроса.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
SetRequestProperty(String, String)	Задает свойство общего запроса.
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
IJavaPeerable.Disposed()	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом. (Унаследовано от JavaObject)

Методы расширения

Имя	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Абстрактный класс `URLConnection` — это суперкласс всех классов, представляющих связь между приложением и URL-адресом.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к