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

Object
URLConnection

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

Java.Net.JarURLConnection

Атрибуты: RegisterAttribute

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

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

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

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

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

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

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

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

Доступ к некоторым полям заголовка выполняется часто. Методы: <ul><li<getContentEncoding>li>getContentLength<li li><getContentTypeli><getDateli ligetExpiration<>/ul>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() методов в InputStream или OutputStreamURLConnection после запроса может освободить сетевые ресурсы, связанные с этим экземпляром, если в спецификациях протокола не указано другое поведение для него.

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

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

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

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

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

Методы

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)	Возвращает значение для поля заголовка `n`<sup>th</sup> .
GetHeaderField(String)	Возвращает значение именованного поля заголовка.
GetHeaderFieldDate(String, Int64)	Возвращает значение именованного поля, проанализированного как date.
GetHeaderFieldInt(String, Int32)	Возвращает значение именованного поля, проанализированного в виде числа.
GetHeaderFieldKey(Int32)	Возвращает ключ для поля заголовка `n`<sup>th</sup> .
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>. (Унаследовано от Object)
Wait(Int64)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> 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-адресом.

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