URLConnection Classe

Référence

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 URLConnection abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une 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

Héritage: Object

Object
URLConnection

Dérivé: Java.Net.HttpURLConnection

Java.Net.JarURLConnection

Attributs: RegisterAttribute

Remarques

La classe URLConnection abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. Les instances de cette classe peuvent être utilisées à la fois pour lire et écrire dans la ressource référencée par l’URL. En général, la création d’une connexion à une URL est un processus multistep :

<center><table border=2 summary="Décrit le processus de création d’une connexion à une URL : openConnection() et connect() au fil du temps. »><tr><th>openConnection()</th/><th><>connect()</tr tr<><>td>Manipulate paramètres qui affectent la connexion à la ressource distante.</td td><>interaction avec la ressource ; champs d’en-tête de requête et contenu.</td></tr></table> ----------------------------> <br>time</center>

<ol><li>L’objet de connexion est créé en appelant la openConnection méthode sur une URL. <li>Les paramètres d’installation et les propriétés de requête générales sont manipulés. <li>La connexion réelle à l’objet distant est établie à l’aide de la connect méthode. <li>L’objet distant devient disponible. Les champs d’en-tête et le contenu de l’objet distant sont accessibles. </ol>

Les paramètres de configuration sont modifiés à l’aide des méthodes suivantes : <ul><li li<>setAllowUserInteractionli><setDoInputli>setUseCaches><<setDoOutput>setIfModifiedSince</ul>

et les propriétés de requête générales sont modifiées à l’aide de la méthode : <ul lisetRequestProperty></ul><>

Les valeurs par défaut pour les paramètres et UseCaches les AllowUserInteraction paramètres peuvent être définies à l’aide des méthodes setDefaultAllowUserInteraction et setDefaultUseCaches.

Chacune des méthodes ci-dessus set a une méthode correspondante get pour récupérer la valeur du paramètre ou de la propriété de requête générale. Les paramètres spécifiques et les propriétés de requête générales applicables sont spécifiques au protocole.

Les méthodes suivantes permettent d’accéder aux champs d’en-tête et au contenu après la connexion à l’objet distant : <ul><li><getContentli li>getOutputStream><<getHeaderField>getInputStream</ul>

Certains champs d’en-tête sont fréquemment accessibles. Les méthodes : <ul>getContentEncoding<><li<>getContentLengthligetDate><><getContentTypeligetExpiration<><>getLastModifed/ul>

fournir un accès pratique à ces champs. La getContentType méthode est utilisée par la getContent méthode pour déterminer le type de l’objet distant ; les sous-classes peuvent trouver pratique de remplacer la getContentType méthode.

Dans le cas courant, tous les paramètres de pré-connexion et les propriétés de requête générales peuvent être ignorés : les paramètres de pré-connexion et les propriétés de requête par défaut sont sensibles. Pour la plupart des clients de cette interface, il n’existe que deux méthodes intéressantes : getInputStream et getContent, qui sont mises en miroir dans la URL classe par des méthodes pratiques.

Pour plus d’informations sur les propriétés de requête et les champs d’en-tête d’une http connexion, consultez : <blockquote>

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

</blockquote>

L’appel des close() méthodes sur le InputStream ou OutputStream d’une URLConnection demande après une demande peut libérer des ressources réseau associées à cette instance, sauf si des spécifications de protocole particulières spécifient des comportements différents pour celui-ci.

Ajouté dans JDK1.0.

Documentation Java pour java.net.URLConnection.

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

URLConnection(IntPtr, JniHandleOwnership)	Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime.
URLConnection(URL)	Construit une connexion URL à l’URL spécifiée.

Propriétés

AllowUserInteraction	Retourne la valeur du `allowUserInteraction` champ pour cet objet. -ou- Définissez la valeur du `allowUserInteraction` champ de ce `URLConnection`.
Class	Retourne la classe runtime de ce `Object`. (Hérité de Object)
Connected	Si `false`, cet objet de connexion n’a pas créé de lien de communication vers l’URL spécifiée.
ConnectTimeout	Retourne le paramètre pour le délai d’expiration de connexion. -ou- Définit une valeur de délai d’expiration spécifiée, en millisecondes, à utiliser lors de l’ouverture d’un lien de communication vers la ressource référencée par cette URLConnection.
Content	Récupère le contenu de cette connexion d’URL.
ContentEncoding	Retourne la valeur du champ d’en-tête `content-encoding` .
ContentLength	Retourne la valeur du champ d’en-tête `content-length` .
ContentLengthLong	Retourne la valeur du champ d’en-tête `content-length` dans la durée.
ContentType	Retourne la valeur du champ d’en-tête `content-type` .
Date	Retourne la valeur du champ d’en-tête `date` .
DefaultAllowUserInteraction	Retourne la valeur par défaut du `allowUserInteraction` champ. -ou- Définit la valeur par défaut du `allowUserInteraction` champ pour tous les objets futurs `URLConnection` sur la valeur spécifiée.
DefaultUseCaches	Retourne la valeur par défaut d’un `URLConnectionuseCaches` indicateur . -ou- Définit la valeur par défaut du `useCaches` champ sur la valeur spécifiée.
DoInput	Retourne la valeur de cet `URLConnectiondoInput` indicateur. -ou- Définit la valeur du `doInput` champ correspondant `URLConnection` à la valeur spécifiée.
DoOutput	Retourne la valeur de cet `URLConnectiondoOutput` indicateur. -ou- Définit la valeur du `doOutput` champ correspondant `URLConnection` à la valeur spécifiée.
Expiration	Retourne la valeur du champ d’en-tête `expires` .
FileNameMap	Retourne une `FileNameMap` implémentation appropriée pour deviner un type de contenu en fonction du composant « fichier » d’une URL. -ou- Définit fileNameMap.
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
HeaderFields	Retourne une carte non modifiable des champs d’en-tête.
IfModifiedSince	Retourne la valeur du champ de `ifModifiedSince` cet objet. -ou- Définit la valeur du champ de `ifModifiedSince` cette `URLConnection` valeur à la valeur spécifiée.
InputStream	Retourne un flux d’entrée qui lit à partir de cette connexion ouverte.
JniIdentityHashCode	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
JniPeerMembers	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL.
LastModified	Retourne la valeur du champ d’en-tête `last-modified` .
OutputStream	Retourne un flux de sortie qui écrit dans cette connexion.
PeerReference	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
Permission	Retourne un objet d’autorisation représentant l’autorisation nécessaire pour rendre la connexion représentée par cet objet.
ReadTimeout	Renvoie le paramètre pour le délai d’attente de lecture. -ou- Définit le délai de lecture sur un délai d’expiration spécifié, en millisecondes.
RequestProperties	Retourne une carte non modifiable des propriétés de requête générales pour cette connexion.
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.
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.
Url	L’URL représente l’objet distant sur le World Wide Web auquel cette connexion est ouverte.
URL	Retourne la valeur de ce `URLConnectionURL` champ.
UseCaches	Retourne la valeur de ce `URLConnectionuseCaches` champ. -ou- Définit la valeur du champ de `useCaches` cette `URLConnection` valeur à la valeur spécifiée.

Méthodes

AddRequestProperty(String, String)	Ajoute une propriété de requête générale spécifiée par une paire clé-valeur.
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Connect()	Ouvre un lien de communication vers la ressource référencée par cette URL, si une telle connexion n’a pas déjà été établie.
ConnectAsync()	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL.
Dispose()	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
Dispose(Boolean)	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetContent(Class[])	Récupère le contenu de cette connexion d’URL.
GetDefaultRequestProperty(String)	Obsolète. Retourne la valeur de la propriété de requête par défaut.
GetHashCode()	Retourne une valeur de code de hachage pour l'objet. (Hérité de Object)
GetHeaderField(Int32)	Retourne la valeur du `n`champ d’en-tête sup></sup>.<
GetHeaderField(String)	Retourne la valeur du champ d’en-tête nommé.
GetHeaderFieldDate(String, Int64)	Retourne la valeur du champ nommé analysé comme date.
GetHeaderFieldInt(String, Int32)	Retourne la valeur du champ nommé analysé sous la forme d’un nombre.
GetHeaderFieldKey(Int32)	Retourne la clé du `n`champ d’en-tête sup></sup>.<
GetHeaderFieldLong(String, Int64)	Retourne la valeur du champ nommé analysé sous la forme d’un nombre.
GetRequestProperty(String)	Retourne la valeur de la propriété de requête générale nommée pour cette connexion.
GuessContentTypeFromName(String)	Tente de déterminer le type de contenu d’un objet, en fonction du composant « fichier » spécifié d’une URL.
GuessContentTypeFromStream(Stream)	Tente de déterminer le type d’un flux d’entrée en fonction des caractères au début du flux d’entrée.
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)
SetContentHandlerFactory(IContentHandlerFactory)	Définit l’application `ContentHandlerFactory` .
SetDefaultRequestProperty(String, String)	Obsolète. Définit la valeur par défaut d’une propriété de requête générale.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetRequestProperty(String, String)	Définit la propriété de requête générale.
ToArray<T>()	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
ToString()	Retourne une représentation de chaîne de l'objet. (Hérité de Object)
UnregisterFromRuntime()	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (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

IJavaPeerable.Disposed()	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
IJavaPeerable.Finalized()	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
IJavaPeerable.JniManagedPeerState	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL. (Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL.
GetJniTypeName(IJavaPeerable)	La classe `URLConnection` abstraite est la superclasse de toutes les classes qui représentent un lien de communication entre l’application et une URL.

S’applique à

Partager via