URL Classe

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 URL representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web.

[Android.Runtime.Register("java/net/URL", DoNotGenerateAcw=true)]
public sealed class URL : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("java/net/URL", DoNotGenerateAcw=true)>]
type URL = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herança: Object

JavaObject

Object
URL

Atributos: RegisterAttribute

Implementações: IJavaObject IJavaPeerable ISerializable IDisposable

Comentários

A classe URL representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. Um recurso pode ser algo tão simples quanto um arquivo ou um diretório ou pode ser uma referência a um objeto mais complicado, como uma consulta a um banco de dados ou a um mecanismo de pesquisa. Mais informações sobre os tipos de URLs e seus formatos podem ser encontradas em: Tipos de URLhttp://web.archive.org/web/20051219043731/http://archive.ncsa.uiuc.edu/SDG/Software/Mosaic/Demo/url-primer.html

Em geral, uma URL pode ser dividida em várias partes. Considere o seguinte exemplo: <blockquote>

http://www.example.com/docs/resource1.html

</blockquote>

A URL acima indica que o protocolo a ser usado é http (Protocolo de Transferência de HiperTexto) e que as informações residem em um computador host chamado www.example.com. As informações sobre esse computador host são nomeadas /docs/resource1.html. O significado exato desse nome no computador host depende do protocolo e do host. As informações normalmente residem em um arquivo, mas podem ser geradas em tempo real. Esse componente da URL é chamado de componente de caminho .

Opcionalmente, uma URL pode especificar uma "porta", que é o número da porta para a qual a conexão TCP é feita no computador host remoto. Se a porta não for especificada, a porta padrão do protocolo será usada. Por exemplo, a porta padrão para http é 80. Uma porta alternativa pode ser especificada como: <blockquote>

http://www.example.com:1080/docs/resource1.html

</blockquote>

A sintaxe de URL é definida por RFC 2396: Uniform Resource Identifiers (URI): Sintaxehttp://www.ietf.org/rfc/rfc2396.txt genérica, alterada por RFC 2732: Formatar endereços IPv6 literais em URLshttp://www.ietf.org/rfc/rfc2732.txt. O formato de endereço IPv6 literal também dá suporte a scope_ids. A sintaxe e o uso de scope_ids é descrito aqui.

Uma URL pode ter acrescentado a ela um "fragmento", também conhecido como "ref" ou "referência". O fragmento é indicado pelo caractere de sinal afiado "#" seguido por mais caracteres. Por exemplo, <blockquote>

http://java.sun.com/index.html#chapter1

</blockquote>

Tecnicamente, esse fragmento não faz parte da URL. Em vez disso, indica que depois que o recurso especificado é recuperado, o aplicativo está especificamente interessado nessa parte do documento que tem a marca chapter1 anexada a ele. O significado de uma marca é específico do recurso.

Um aplicativo também pode especificar uma "URL relativa", que contém apenas informações suficientes para acessar o recurso em relação a outra URL. URLs relativas são frequentemente usadas em páginas HTML. Por exemplo, se o conteúdo da URL: <blockquote>

http://java.sun.com/index.html

</blockquote> contido nela na URL relativa: <blockquote>

FAQ.html

</blockquote> seria uma abreviação para: <blockquote>

http://java.sun.com/FAQ.html

</blockquote>

A URL relativa não precisa especificar todos os componentes de uma URL. Se o protocolo, o nome do host ou o número da porta estiver ausente, o valor será herdado da URL totalmente especificada. O componente de arquivo deve ser especificado. O fragmento opcional não é herdado.

A classe URL não codifica ou decodifica nenhum componente de URL de acordo com o mecanismo de escape definido em RFC2396. É responsabilidade do chamador codificar todos os campos, que precisam ser escapados antes da URL de chamada e também decodificar todos os campos com escape, que são retornados da URL. Além disso, como a URL não tem conhecimento de escape de URL, ela não reconhece a equivalência entre a forma codificada ou decodificada da mesma URL. Por exemplo, as duas URLs:<br>

http://foo.com/hello world/ and http://foo.com/hello%20world

seria considerado não igual um ao outro.

Observe que a java.net.URI classe executa o escape de seus campos de componente em determinadas circunstâncias. A maneira recomendada de gerenciar a codificação e a decodificação de URLs é usar java.net.URIe converter entre essas duas classes usando #toURI() e URI#toURL().

As URLEncoder classes e também URLDecoder podem ser usadas, mas somente para codificação de formulário HTML, que não é o mesmo que o esquema de codificação definido em RFC2396.

Adicionado no JDK1.0.

Java documentação para java.net.URL.

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
URL(String, String, Int32, String, URLStreamHandler)	Cria um `URL` objeto do especificado`protocol`, , `hostport` número `file`e `handler`.
URL(String, String, Int32, String)	Cria um `URL` objeto do especificado`protocol`, , `hostport` número e `file`.
URL(String, String, String)	Cria uma URL com base no nome, `protocol` nome e `host` nome especificados`file`.
URL(String)	Cria um `URL` objeto a partir da `String` representação.
URL(URL, String, URLStreamHandler)	Cria uma URL analisando a especificação fornecida com o manipulador especificado em um contexto especificado.
URL(URL, String)	Cria uma URL analisando a especificação especificada em um contexto especificado.

Propriedades

Nome	Description
Authority	Obtém a parte de autoridade disso `URL`.
Class	Retorna a classe de runtime deste `Object`. (Herdado de Object)
Content	Obtém o conteúdo dessa URL.
DefaultPort	Obtém o número de porta padrão do protocolo associado a isso `URL`.
File	Obtém o nome do arquivo deste `URL`.
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
Host	Obtém o nome do host disso `URL`, se aplicável.
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
JniPeerMembers	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web.
Path	Obtém a parte do caminho deste `URL`.
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
Port	Obtém o número da porta deste `URL`.
Protocol	Obtém o nome do protocolo deste `URL`.
Query	Obtém a parte da consulta deste `URL`.
Ref	Obtém a âncora (também conhecida como "referência") deste `URL`.
ThresholdClass	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object)
ThresholdType	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object)
UserInfo	Obtém a parte userInfo deste `URL`.

Métodos

Nome	Description
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
Equals(Object)	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
GetContent(Class[])	Obtém o conteúdo dessa URL.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
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)
OpenConnection()	Retorna uma `java.net.URLConnection URLConnection` instância que representa uma conexão com o objeto remoto referenciado pelo `URL`.
OpenConnection(Proxy)	O mesmo que `#openConnection()`, exceto que a conexão será feita por meio do proxy especificado; Os manipuladores de protocolo que não dão suporte ao proxing ignorarão o parâmetro proxy e farão uma conexão normal.
OpenStream()	Abre uma conexão com isso `URL` e retorna um `InputStream` para leitura dessa conexão.
SameFile(URL)	Compara duas URLs, excluindo o componente de fragmento.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
SetURLStreamHandlerFactory(IURLStreamHandlerFactory)	Define o . de `URLStreamHandlerFactory`um aplicativo.
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToExternalForm()	Constrói uma representação de cadeia de caracteres deste `URL`.
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
ToURI()	Retorna um `java.net.URI` equivalente a essa URL.
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object)
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 `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
IJavaPeerable.Finalized()	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web. (Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web.

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância `self`.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada pelo tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	A classe `URL` representa um Uniform Resource Locator, um ponteiro para um "recurso" na World Wide Web.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a