URLConnection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
La classe astratta è la superclasse URLConnection
di tutte le classi che rappresentano un collegamento di comunicazione tra l'applicazione e un 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
- Ereditarietà
- Derivato
- Attributi
Commenti
La classe URLConnection
astratta è la superclasse di tutte le classi che rappresentano un collegamento di comunicazione tra l'applicazione e un URL. Le istanze di questa classe possono essere usate sia per leggere da che per scrivere nella risorsa a cui fa riferimento l'URL. In generale, la creazione di una connessione a un URL è un processo a più passaggi:
<center><table border=2 summary="Descrive il processo di creazione di una connessione a un URL: openConnection() e connect() nel tempo".><tr><th><openConnection()
/th<>/th><connect()
<>/tr tr<><>td>Manipola parametri che influiscono sulla connessione alla risorsa remota.</td td><>Interagire con la risorsa; campi e contenuto dell'intestazione di query.</td></tr></table> ----------------------------> <br>time</center>
<ol><li>L'oggetto connessione viene creato richiamando il openConnection
metodo su un URL. <li>I parametri di installazione e le proprietà di richiesta generali vengono modificati. <li>La connessione effettiva all'oggetto remoto viene effettuata utilizzando il connect
metodo . <li>L'oggetto remoto diventa disponibile. È possibile accedere ai campi di intestazione e al contenuto dell'oggetto remoto. </Ol>
I parametri di installazione vengono modificati usando i metodi seguenti: <ul><li>setAllowUserInteraction
<li>setDoInput
<li>setDoOutput
<li><setIfModifiedSince
<>setUseCaches
/ul>
e le proprietà di richiesta generali vengono modificate usando il metodo ul <><li>setRequestProperty
</ul>
I valori predefiniti per i AllowUserInteraction
parametri e UseCaches
possono essere impostati usando i metodi setDefaultAllowUserInteraction
e setDefaultUseCaches
.
Ognuno dei metodi precedenti set
dispone di un metodo corrispondente get
per recuperare il valore del parametro o della proprietà della richiesta generale. I parametri specifici e le proprietà di richiesta generali applicabili sono specifici del protocollo.
I metodi seguenti vengono usati per accedere ai campi di intestazione e al contenuto dopo la connessione all'oggetto remoto: <ul><li><getContent
li>getHeaderField
<li><getInputStream
<>getOutputStream
/ul>
Alcuni campi di intestazione sono accessibili di frequente. I metodi: <ul><li><getContentEncoding
li>getDate
>><getContentType
getContentLength
<<ligetExpiration
<><>getLastModifed
/ul>
fornire un accesso pratico a questi campi. Il getContentType
metodo viene utilizzato dal getContent
metodo per determinare il tipo dell'oggetto remoto. Le sottoclassi possono risultare utili per eseguire l'override del getContentType
metodo.
Nel caso comune, tutti i parametri di pre-connessione e le proprietà di richiesta generali possono essere ignorati: i parametri di pre-connessione e le proprietà della richiesta vengono usati per impostazione predefinita come valori sensibili. Per la maggior parte dei client di questa interfaccia, esistono solo due metodi interessanti: getInputStream
e getContent
, che vengono speculari nella URL
classe tramite metodi pratici.
Per altre informazioni sulle proprietà della richiesta e sui campi di intestazione di una http
connessione, vedere: <blockquote>
<a href="http://www.ietf.org/rfc/rfc2616.txt">http://www.ietf.org/rfc/rfc2616.txt</a>
</Blockquote>
Richiamando i close()
metodi sull'oggetto InputStream
o OutputStream
di una URLConnection
richiesta dopo che una richiesta può liberare le risorse di rete associate a questa istanza, a meno che specifiche del protocollo non specifichino comportamenti diversi per esso.
Aggiunto in JDK1.0.
Documentazione Java per java.net.URLConnection
.
Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .
Costruttori
URLConnection(IntPtr, JniHandleOwnership) |
Costruttore utilizzato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
URLConnection(URL) |
Costruisce una connessione URL all'URL specificato. |
Proprietà
AllowUserInteraction |
Restituisce il valore del |
Class |
Restituisce la classe di runtime di questo |
Connected |
Se |
ConnectTimeout |
Restituisce l'impostazione per il timeout della connessione. -oppure- Imposta un valore di timeout specificato, in millisecondi, da utilizzare quando si apre un collegamento di comunicazione alla risorsa a cui fa riferimento questo URLConnection. |
Content |
Recupera il contenuto di questa connessione URL. |
ContentEncoding |
Restituisce il valore del campo dell'intestazione |
ContentLength |
Restituisce il valore del campo dell'intestazione |
ContentLengthLong |
Restituisce il valore del campo di |
ContentType |
Restituisce il valore del campo dell'intestazione |
Date |
Restituisce il valore del campo dell'intestazione |
DefaultAllowUserInteraction |
Restituisce il valore predefinito del |
DefaultUseCaches |
Restituisce il valore predefinito del flag di un |
DoInput |
Restituisce il valore del |
DoOutput |
Restituisce il valore del |
Expiration |
Restituisce il valore del campo dell'intestazione |
FileNameMap |
Restituisce un'implementazione |
Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
HeaderFields |
Restituisce una mappa non modificabile dei campi di intestazione. |
IfModifiedSince |
Restituisce il valore del campo dell'oggetto |
InputStream |
Restituisce un flusso di input che legge da questa connessione aperta. |
JniIdentityHashCode |
La classe astratta è la superclasse |
JniPeerMembers |
La classe astratta è la superclasse |
LastModified |
Restituisce il valore del campo dell'intestazione |
OutputStream |
Restituisce un flusso di output che scrive in questa connessione. |
PeerReference |
La classe astratta è la superclasse |
Permission |
Restituisce un oggetto autorizzazione che rappresenta l'autorizzazione necessaria per stabilire la connessione rappresentata da questo oggetto. |
ReadTimeout |
Restituisce l'impostazione per il timeout di lettura. -oppure- Imposta il timeout di lettura su un timeout specificato, espresso in millisecondi. |
RequestProperties |
Restituisce una mappa non modificabile delle proprietà di richiesta generali per questa connessione. |
ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
Url |
L'URL rappresenta l'oggetto remoto nel World Wide Web a cui viene aperta la connessione. |
URL |
Restituisce il valore del campo di |
UseCaches |
Restituisce il valore del campo di |
Metodi
AddRequestProperty(String, String) |
Aggiunge una proprietà di richiesta generale specificata da una coppia chiave-valore. |
Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
Connect() |
Apre un collegamento di comunicazione alla risorsa a cui fa riferimento questo URL, se tale connessione non è già stata stabilita. |
ConnectAsync() |
La classe astratta è la superclasse |
Dispose() |
La classe astratta è la superclasse |
Dispose(Boolean) |
La classe astratta è la superclasse |
Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
GetContent(Class[]) |
Recupera il contenuto di questa connessione URL. |
GetDefaultRequestProperty(String) |
Obsoleti.
Restituisce il valore della proprietà della richiesta predefinita. |
GetHashCode() |
Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object) |
GetHeaderField(Int32) |
Restituisce il valore per il |
GetHeaderField(String) |
Restituisce il valore del campo dell'intestazione denominata. |
GetHeaderFieldDate(String, Int64) |
Restituisce il valore del campo denominato analizzato come data. |
GetHeaderFieldInt(String, Int32) |
Restituisce il valore del campo denominato analizzato come numero. |
GetHeaderFieldKey(Int32) |
Restituisce la chiave per il |
GetHeaderFieldLong(String, Int64) |
Restituisce il valore del campo denominato analizzato come numero. |
GetRequestProperty(String) |
Restituisce il valore della proprietà richiesta generale denominata per questa connessione. |
GuessContentTypeFromName(String) |
Tenta di determinare il tipo di contenuto di un oggetto, in base al componente "file" specificato di un URL. |
GuessContentTypeFromStream(Stream) |
Tenta di determinare il tipo di un flusso di input in base ai caratteri all'inizio del flusso di input. |
JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
NotifyAll() |
Riattiva tutti i thread in attesa del monitoraggio di questo oggetto. (Ereditato da Object) |
SetContentHandlerFactory(IContentHandlerFactory) |
Imposta l'oggetto |
SetDefaultRequestProperty(String, String) |
Obsoleti.
Imposta il valore predefinito di una proprietà di richiesta generale. |
SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
SetRequestProperty(String, String) |
Imposta la proprietà della richiesta generale. |
ToArray<T>() |
La classe astratta è la superclasse |
ToString() |
Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object) |
UnregisterFromRuntime() |
La classe astratta è la superclasse |
Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una>notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale. (Ereditato da Object) |
Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
IJavaPeerable.Disposed() |
La classe astratta è la superclasse |
IJavaPeerable.DisposeUnlessReferenced() |
La classe astratta è la superclasse |
IJavaPeerable.Finalized() |
La classe astratta è la superclasse |
IJavaPeerable.JniManagedPeerState |
La classe astratta è la superclasse |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
La classe astratta è la superclasse |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
La classe astratta è la superclasse |
IJavaPeerable.SetPeerReference(JniObjectReference) |
La classe astratta è la superclasse |
Metodi di estensione
JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo verificato dal runtime Android. |
JavaCast<TResult>(IJavaObject) |
La classe astratta è la superclasse |
GetJniTypeName(IJavaPeerable) |
La classe astratta è la superclasse |