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 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
- Derivado
- Atributos
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 |
| Class |
Retorna a classe de tempo de execução deste |
| Connected |
Se |
| 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 |
| ContentLength |
Retorna o valor do campo de |
| ContentLengthLong |
Retorna o |
| 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 deste |
| DoOutput |
Retorna o valor deste |
| 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 deste objeto |
| InputStream |
Retorna um fluxo de entrada que lê a partir 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 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 |
| UseCaches |
Retorna o valor deste |
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 |
| 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 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 |
| 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é 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 |
| 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
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo verificada em tempo de execução do Android. |
| JavaCast<TResult>(IJavaObject) |
A classe |
| GetJniTypeName(IJavaPeerable) |
A classe |