URL Classe

Définition

Espace de noms:: Java.Net

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

La classe URL représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le 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

Héritage: Object

JavaObject

Object
URL

Attributs: RegisterAttribute

Implémente: IJavaObject IJavaPeerable ISerializable IDisposable

Remarques

La classe URL représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. Une ressource peut être aussi simple qu’un fichier ou un répertoire, ou il peut s’agir d’une référence à un objet plus complexe, tel qu’une requête vers une base de données ou un moteur de recherche. Pour plus d’informations sur les types d’URL et leurs formats, consultez : Types d’URLhttp://web.archive.org/web/20051219043731/http://archive.ncsa.uiuc.edu/SDG/Software/Mosaic/Demo/url-primer.html

En général, une URL peut être divisée en plusieurs parties. Prenons l’exemple suivant : <blockquote>

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

</blockquote>

L’URL ci-dessus indique que le protocole à utiliser est http (Protocole de transfert HyperText) et que les informations résident sur un ordinateur hôte nommé www.example.com. Les informations sur cet ordinateur hôte sont nommées /docs/resource1.html. La signification exacte de ce nom sur l’ordinateur hôte est dépendante du protocole et dépendante de l’hôte. Les informations résident normalement dans un fichier, mais elles peuvent être générées à la volée. Ce composant de l’URL est appelé composant de chemin d’accès .

Une URL peut éventuellement spécifier un « port », qui est le numéro de port vers lequel la connexion TCP est établie sur l’ordinateur hôte distant. Si le port n’est pas spécifié, le port par défaut du protocole est utilisé à la place. Par exemple, le port par défaut est http80. Un autre port peut être spécifié comme suit : <blockquote>

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

</blockquote>

La syntaxe de l’objet URL est définie par RFC ; 2396 : Uri (Uniform Resource Identifiers) : Syntaxehttp://www.ietf.org/rfc/rfc2396.txt générique modifiée par RFC ; 2732 : Format des adresses IPv6 littérales dans leshttp://www.ietf.org/rfc/rfc2732.txt URL. Le format d’adresse IPv6 littéral prend également en charge scope_ids. La syntaxe et l’utilisation de scope_ids sont décrites ici.

Une URL peut l’avoir ajoutée à un « fragment », également appelée « ref » ou « référence ». Le fragment est indiqué par le caractère de signe aiguisé « # » suivi de caractères supplémentaires. Par exemple, <blockquote>

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

</blockquote>

Ce fragment ne fait pas partie techniquement de l’URL. Il indique plutôt qu’après la récupération de la ressource spécifiée, l’application s’intéresse spécifiquement à cette partie du document qui a la balise chapter1 attachée à celle-ci. La signification d’une balise est spécifique à la ressource.

Une application peut également spécifier une « URL relative », qui contient uniquement suffisamment d’informations pour atteindre la ressource par rapport à une autre URL. Les URL relatives sont fréquemment utilisées dans les pages HTML. Par exemple, si le contenu de l’URL : <blockquote>

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

</blockquote> contenu dans celui-ci l’URL relative : <blockquote>

FAQ.html

</blockquote> , il s’agit d’un raccourci pour : <blockquote>

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

</blockquote>

L’URL relative n’a pas besoin de spécifier tous les composants d’une URL. Si le protocole, le nom d’hôte ou le numéro de port sont manquants, la valeur est héritée de l’URL entièrement spécifiée. Le composant de fichier doit être spécifié. Le fragment facultatif n’est pas hérité.

La classe d’URL n’est pas elle-même encode ou décode les composants d’URL en fonction du mécanisme d’échappement défini dans RFC2396. Il incombe à l’appelant d’encoder tous les champs, qui doivent être échappés avant d’appeler l’URL, ainsi que de décoder les champs échappés qui sont retournés à partir de l’URL. En outre, étant donné que l’URL ne connaît pas l’échappement d’URL, elle ne reconnaît pas l’équivalence entre la forme codée ou décodée de la même URL. Par exemple, les deux URL :<br>

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

serait considéré comme non égal à l’autre.

Notez que la java.net.URI classe effectue l’échappement de ses champs de composant dans certaines circonstances. La méthode recommandée pour gérer l’encodage et le décodage des URL consiste à utiliser java.net.URI, et à convertir entre ces deux classes à l’aide #toURI() et URI#toURL().

Les URLEncoder classes peuvent URLDecoder également être utilisées, mais uniquement pour l’encodage de formulaire HTML, ce qui n’est pas le même que le schéma d’encodage défini dans RFC2396.

Ajouté dans JDK1.0.

Documentation Java pour java.net.URL.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Constructeurs

Nom	Description
URL(String, String, Int32, String, URLStreamHandler)	Crée un `URL` objet à partir de l’objet spécifié `protocol`, `host`nombre `port` , `file`et `handler`.
URL(String, String, Int32, String)	Crée un `URL` objet à partir de l’objet spécifié `protocol`, `hostport` nombre et `file`.
URL(String, String, String)	Crée une URL à partir du nom, `protocol` du nom et `host` du nom spécifiés`file`.
URL(String)	Crée un `URL` objet à partir de la `String` représentation.
URL(URL, String, URLStreamHandler)	Crée une URL en analysant la spécification donnée avec le gestionnaire spécifié dans un contexte spécifié.
URL(URL, String)	Crée une URL en analysant la spécification donnée dans un contexte spécifié.

Propriétés

Nom	Description
Authority	Obtient la partie autorité de ce `URL`.
Class	Retourne la classe runtime de ce `Object`. (Hérité de Object)
Content	Obtient le contenu de cette URL.
DefaultPort	Obtient le numéro de port par défaut du protocole associé à ce `URL`.
File	Obtient le nom de fichier de ce `URL`.
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
Host	Obtient le nom d’hôte de ce `URL`paramètre, le cas échéant.
JniIdentityHashCode	Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object)
JniManagedPeerState	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
JniPeerMembers	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web.
Path	Obtient la partie chemin d’accès de ce `URL`.
PeerReference	Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object)
Port	Obtient le numéro de port de ce `URL`.
Protocol	Obtient le nom du protocole de ce `URL`.
Query	Obtient la partie de requête de ce `URL`.
Ref	Obtient l’ancre (également appelée « référence ») de ce `URL`.
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)
UserInfo	Obtient la partie userInfo de ce `URL`.

Méthodes

Nom	Description
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
Dispose()	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
Dispose(Boolean)	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
DisposeUnlessReferenced()	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
Equals(Object)	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetContent(Class[])	Obtient le contenu de cette URL.
GetHashCode()	Retourne une valeur de code de hachage pour l'objet. (Hérité de Object)
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
OpenConnection()	Retourne une instance qui représente une `java.net.URLConnection URLConnection` connexion à l’objet distant référencé par le `URL`.
OpenConnection(Proxy)	Identique à `#openConnection()`, sauf que la connexion sera établie via le proxy spécifié ; Les gestionnaires de protocole qui ne prennent pas en charge le proxy ignorent le paramètre proxy et effectuent une connexion normale.
OpenStream()	Ouvre une connexion à cette `URL` connexion et retourne une `InputStream` valeur de lecture à partir de cette connexion.
SameFile(URL)	Compare deux URL, à l’exclusion du composant fragment.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
SetURLStreamHandlerFactory(IURLStreamHandlerFactory)	Définit le `URLStreamHandlerFactory`fichier .
ToArray<T>()	Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object)
ToExternalForm()	Construit une représentation sous forme de chaîne de ce `URL`.
ToString()	Retourne une représentation de chaîne de l'objet. (Hérité de Object)
ToURI()	Retourne un `java.net.URI` équivalent à cette URL.
UnregisterFromRuntime()	Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
IJavaPeerable.Disposed()	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
IJavaPeerable.Finalized()	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web. (Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web.

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	La classe `URL` représente un localisateur de ressources uniforme, un pointeur vers une « ressource » sur le World Wide Web.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à