URLConnection Classe
Definição
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 vínculo de comunicações 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
- Derivado
- Atributos
Comentários
A classe URLConnection abstrata é a superclasse de todas as classes que representam um vínculo de comunicações entre o aplicativo e uma URL. Instâncias dessa classe podem ser usadas para ler e gravar no recurso referenciado pela URL. Em geral, a criação de 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></th<connect()><>/tr tr><td><>Manipular parâmetros que afetam a conexão com o recurso remoto.</td><td>Interaja com o recurso; consultar campos de cabeçalho e conteúdo.</td></tr></table> ----------------------------> <br>time</center>
<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 de solicitação geral 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><setAllowUserInteractionlisetDoInput><li><setDoOutputlisetIfModifiedSince<><>setUseCaches/ul>
e as propriedades de solicitação geral são modificadas usando o método: <ul><li>setRequestProperty</ul>
Os valores padrão para os parâmetros e os AllowUserInteraction parâmetros 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 métodos a seguir 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<getHeaderField>li<>getInputStreamli>getOutputStream</ul>
Determinados campos de cabeçalho são acessados com frequência. Os métodos: <ul><li><getContentEncodingli<>getContentLengthli>getDate<><getContentTypeli li><>getExpiration<getLastModifed/ul>
fornecer acesso conveniente a esses campos. O getContentType método é usado pelo getContent método para determinar o tipo do objeto remoto; as subclasses podem achar conveniente substituir o getContentType método.
No caso comum, todos os parâmetros de pré-conexão e as propriedades de solicitação geral podem ser ignorados: os parâmetros de pré-conexão e as propriedades de solicitação padrão para valores sensatos. Para a maioria dos clientes dessa interface, há apenas dois métodos interessantes: getInputStream e getContent, que são espelhados na URL classe por métodos de conveniência.
Mais informações sobre as propriedades da 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 após uma solicitação URLConnection 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.
Java documentação para java.net.URLConnection.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Construtores
| Nome | Description |
|---|---|
| URLConnection(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
| URLConnection(URL) |
Constrói uma conexão de URL com a URL especificada. |
Propriedades
| Nome | Description |
|---|---|
| AllowUserInteraction |
Retorna o valor do |
| Class |
Retorna a classe de runtime deste |
| Connected |
Se |
| ConnectTimeout |
Retorna a configuração para o tempo limite de conexão. -ou- Define um valor de tempo limite especificado, em milissegundos, a ser usado ao abrir um link de comunicações para o recurso referenciado por essa URLConnection. |
| Content |
Recupera o conteúdo dessa conexão de URL. |
| ContentEncoding |
Retorna o valor do campo de |
| ContentLength |
Retorna o valor do campo de |
| ContentLengthLong |
Retorna o valor do campo de |
| ContentType |
Retorna o valor do campo de |
| Date |
Retorna o valor do campo de |
| DefaultAllowUserInteraction |
Retorna o valor padrão do |
| DefaultUseCaches |
Retorna o valor padrão de um |
| DoInput |
Retorna o valor desse |
| DoOutput |
Retorna o valor desse |
| Expiration |
Retorna o valor do campo de |
| FileNameMap |
Retorna uma |
| 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 desse objeto |
| InputStream |
Retorna um fluxo de entrada que lê dessa conexão aberta. |
| JniIdentityHashCode |
A classe |
| JniPeerMembers |
A classe |
| LastModified |
Retorna o valor do campo de |
| OutputStream |
Retorna um fluxo de saída que grava nessa conexão. |
| PeerReference |
A classe |
| Permission |
Retorna um objeto de permissão que representa a permissão necessária para tornar a conexão representada por esse objeto. |
| ReadTimeout |
Retorna a configuração de tempo limite de leitura. -ou- Define o tempo limite de leitura como 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 |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| ThresholdType |
Essa API dá suporte à infraestrutura do 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 |
| UseCaches |
Retorna o valor deste |
Métodos
| Nome | Description |
|---|---|
| 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ções para o recurso referenciado por essa URL, se essa conexão ainda não tiver sido estabelecida. |
| ConnectAsync() |
A classe |
| Dispose() |
A classe |
| Dispose(Boolean) |
A classe |
| 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 |
| 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 |
| 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 essa 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 |
| 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 |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
A classe |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <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 por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IJavaPeerable.Disposed() |
A classe |
| IJavaPeerable.DisposeUnlessReferenced() |
A classe |
| IJavaPeerable.Finalized() |
A classe |
| IJavaPeerable.JniManagedPeerState |
A classe |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
A classe |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
A classe |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
A classe |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo verificada pelo tempo de execução do Android. |
| JavaCast<TResult>(IJavaObject) |
A classe |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |