URLConnection Classe

Referência

Definição

Namespace:: Java.Net

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

A classe URLConnection abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma 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

Herança: Object

Object
URLConnection

Derivado: Java.Net.HttpURLConnection

Java.Net.JarURLConnection

Atributos: RegisterAttribute

Comentários

A classe URLConnection abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. As instâncias dessa classe podem ser usadas para ler e gravar no recurso referenciado pela URL. Em geral, criar uma conexão com uma URL é um processo de várias etapas:

<center><table border=2 summary="Descreve o processo de criação de uma conexão com uma URL: openConnection() e connect() ao longo do tempo."><><tr thopenConnection()></th<>th>connect()</th></tr<>tr td><>Manipula parâmetros que afetam a conexão com o recurso remoto.</td><td>Interaja com o recurso, consulte campos de cabeçalho e conteúdo.</td></tr></tabela> ----------------------------> <BR>Tempo</Centro>

<ol><li>O objeto de conexão é criado invocando o openConnection método em uma URL. <li>Os parâmetros de instalação e as propriedades gerais de solicitação são manipulados. <li>A conexão real com o objeto remoto é feita, usando o connect método. <li>O objeto remoto fica disponível. Os campos de cabeçalho e o conteúdo do objeto remoto podem ser acessados. </Ol>

Os parâmetros de instalação são modificados usando os seguintes métodos: <ul<>li><setAllowUserInteractionli<>setDoInputlisetDoOutput<>li><>setIfModifiedSince<setUseCaches/ul>

e as propriedades gerais de solicitação são modificadas usando o método: <ul><li>setRequestProperty</ul>

Os valores padrão para os AllowUserInteraction parâmetros e UseCaches podem ser definidos usando os métodos setDefaultAllowUserInteraction e setDefaultUseCaches.

Cada um dos métodos acima set tem um método correspondente get para recuperar o valor do parâmetro ou da propriedade de solicitação geral. Os parâmetros específicos e as propriedades gerais de solicitação aplicáveis são específicos do protocolo.

Os seguintes métodos são usados para acessar os campos de cabeçalho e o conteúdo depois que a conexão é feita com o objeto remoto: <ul><li>getContent<li><getHeaderFieldli>getInputStream<li>getOutputStream</ul>

Determinados campos de cabeçalho são acessados com frequência. Os métodos: <ul><li<getContentEncoding>li<getContentLength>ligetContentType><li><getDateligetExpiration<><>getLastModifed/ul>

fornecer acesso conveniente a esses campos. O getContentType método é usado pelo getContent método para determinar o tipo do objeto remoto, subclasses podem achar conveniente substituir o getContentType método.

No caso comum, todos os parâmetros de pré-conexão e as propriedades gerais de solicitação podem ser ignorados: os parâmetros de pré-conexão e as propriedades de solicitação têm como padrão valores sensíveis. Para a URL maioria dos clientes dessa interface, há apenas dois métodos interessantes: getInputStream e getContent, que são espelhados na classe por métodos de conveniência.

Mais informações sobre as propriedades de solicitação e os campos de cabeçalho de uma http conexão podem ser encontradas em: <blockquote>

<a href="http://www.ietf.org/rfc/rfc2616.txt">http://www.ietf.org/rfc/rfc2616.txt</a>

</blockquote>

Invocar os close() métodos no InputStream ou OutputStream de uma URLConnection após uma solicitação pode liberar recursos de rede associados a essa instância, a menos que especificações de protocolo específicas especifiquem comportamentos diferentes para ela.

Adicionado no JDK1.0.

Documentação Java para java.net.URLConnection.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Construtores

URLConnection(IntPtr, JniHandleOwnership)	Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo tempo de execução.
URLConnection(URL)	Constrói uma conexão de URL com a URL especificada.

Propriedades

AllowUserInteraction	Retorna o `allowUserInteraction` valor do campo para este objeto. -ou- Defina o valor do `allowUserInteraction` campo deste `URLConnection`.
Class	Retorna a classe de tempo de execução deste `Object`. (Herdado de Object)
Connected	Se `false`, esse objeto de conexão não tiver criado um link de comunicação para a URL especificada.
ConnectTimeout	Retorna a configuração de tempo limite de conexão. -ou- Define um valor de tempo limite especificado, em milissegundos, a ser usado ao abrir um link de comunicação para o recurso referenciado por este URLConnection.
Content	Recupera o conteúdo dessa conexão de URL.
ContentEncoding	Retorna o valor do campo de `content-encoding` cabeçalho.
ContentLength	Retorna o valor do campo de `content-length` cabeçalho.
ContentLengthLong	Retorna o `content-length` valor do campo de cabeçalho como um longo.
ContentType	Retorna o valor do campo de `content-type` cabeçalho.
Date	Retorna o valor do campo de `date` cabeçalho.
DefaultAllowUserInteraction	Retorna o valor padrão do `allowUserInteraction` campo. -ou- Define o `allowUserInteraction` valor padrão do campo para todos os objetos futuros `URLConnection` para o valor especificado.
DefaultUseCaches	Retorna o valor padrão de um `URLConnection`sinalizador 's `useCaches` . -ou- Define o valor padrão do campo para o `useCaches` valor especificado.
DoInput	Retorna o valor deste `URLConnection`sinalizador .`doInput` -ou- Define o `doInput` valor do campo para isso `URLConnection` como o valor especificado.
DoOutput	Retorna o valor deste `URLConnection`sinalizador .`doOutput` -ou- Define o `doOutput` valor do campo para isso `URLConnection` como o valor especificado.
Expiration	Retorna o valor do campo de `expires` cabeçalho.
FileNameMap	Retorna uma `FileNameMap` implementação adequada para adivinhar um tipo de conteúdo com base no componente "arquivo" de uma URL. -ou- Define o FileNameMap.
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
HeaderFields	Retorna um Mapa não modificável dos campos de cabeçalho.
IfModifiedSince	Retorna o valor do campo deste objeto `ifModifiedSince` . -ou- Define o `ifModifiedSince` valor do campo deste `URLConnection` para o valor especificado.
InputStream	Retorna um fluxo de entrada que lê a partir dessa conexão aberta.
JniIdentityHashCode	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
JniPeerMembers	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL.
LastModified	Retorna o valor do campo de `last-modified` cabeçalho.
OutputStream	Retorna um fluxo de saída que grava nessa conexão.
PeerReference	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
Permission	Retorna um objeto de permissão que representa a permissão necessária para fazer a conexão representada por esse objeto.
ReadTimeout	Retorna a configuração de tempo limite de leitura. -ou- Define o tempo limite de leitura para um tempo limite especificado, em milissegundos.
RequestProperties	Retorna um mapa não modificável das propriedades gerais de solicitação para essa conexão.
ThresholdClass	Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
Url	A URL representa o objeto remoto na World Wide Web para o qual essa conexão é aberta.
URL	Retorna o valor deste `URLConnection`campo .`URL`
UseCaches	Retorna o valor deste `URLConnection`campo .`useCaches` -ou- Define o `useCaches` valor do campo deste `URLConnection` para o valor especificado.

Métodos

AddRequestProperty(String, String)	Adiciona uma propriedade de solicitação geral especificada por um par chave-valor.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Connect()	Abre um link de comunicação para o recurso referenciado por essa URL, se essa conexão ainda não tiver sido estabelecida.
ConnectAsync()	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL.
Dispose()	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
Dispose(Boolean)	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
Equals(Object)	Indica se algum outro objeto é "igual" a este. (Herdado de Object)
GetContent(Class[])	Recupera o conteúdo dessa conexão de URL.
GetDefaultRequestProperty(String)	Obsoleto. Retorna o valor da propriedade de solicitação padrão.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
GetHeaderField(Int32)	Retorna o valor do `n`<campo de cabeçalho sup>th</sup> .
GetHeaderField(String)	Retorna o valor do campo de cabeçalho nomeado.
GetHeaderFieldDate(String, Int64)	Retorna o valor do campo nomeado analisado como data.
GetHeaderFieldInt(String, Int32)	Retorna o valor do campo nomeado analisado como um número.
GetHeaderFieldKey(Int32)	Retorna a chave para o `n`<campo de cabeçalho sup>th</sup> .
GetHeaderFieldLong(String, Int64)	Retorna o valor do campo nomeado analisado como um número.
GetRequestProperty(String)	Retorna o valor da propriedade de solicitação geral nomeada para esta conexão.
GuessContentTypeFromName(String)	Tenta determinar o tipo de conteúdo de um objeto, com base no componente "arquivo" especificado de uma URL.
GuessContentTypeFromStream(Stream)	Tenta determinar o tipo de um fluxo de entrada com base nos caracteres no início do fluxo de entrada.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
SetContentHandlerFactory(IContentHandlerFactory)	Define o `ContentHandlerFactory` de um aplicativo.
SetDefaultRequestProperty(String, String)	Obsoleto. Define o valor padrão de uma propriedade de solicitação geral.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle. (Herdado de Object)
SetRequestProperty(String, String)	Define a propriedade de solicitação geral.
ToArray<T>()	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até que ele seja ativado, normalmente sendo <em notificado</em> ou <em>interrompido</em>>. (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido. (Herdado de Object)

Implantações explícitas de interface

IJavaPeerable.Disposed()	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
IJavaPeerable.Finalized()	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL. (Herdado de Object)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada em tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL.
GetJniTypeName(IJavaPeerable)	A classe `URLConnection` abstrata é a superclasse de todas as classes que representam um link de comunicação entre o aplicativo e uma URL.

Aplica-se a

Compartilhar via