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 URLConnection
astratta è la superclasse 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/thopenConnection()
><<>connect()
<>/th></tr tr<><>td>Manipola parametri che influiscono sulla connessione alla risorsa remota.</td td><>Interagire con la risorsa; campi e contenuto dell'intestazione della 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. </olo>
I parametri di installazione vengono modificati usando i metodi seguenti: <ul><li>>setDoInput
<setAllowUserInteraction
<li><setDoOutput
lisetIfModifiedSince
<><>setUseCaches
/ul>
e le proprietà generali della richiesta 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à di 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
/ul>getOutputStream
<>
Di frequente si accede a determinati campi di intestazione. I metodi: <ul><li>getContentEncoding
<li>getLastModifed
><getExpiration
getDate
<>getContentLength
><<getContentType
<>/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 rispecchiati nella URL
classe tramite metodi pratici.
Altre informazioni sui campi di intestazione e proprietà della richiesta di una http
connessione sono disponibili in: <blockquote>
<a href="http://www.ietf.org/rfc/rfc2616.txt">http://www.ietf.org/rfc/rfc2616.txt</a>
</blockquote>
Richiamare i close()
metodi su 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 specifiche del protocollo non specifichino comportamenti diversi.
Aggiunta in JDK1.0.
Documentazione java per java.net.URLConnection
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
Costruttori
URLConnection(IntPtr, JniHandleOwnership) |
Costruttore usato 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 |
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 |
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 dell'intestazione. |
IfModifiedSince |
Restituisce il valore del campo dell'oggetto |
InputStream |
Restituisce un flusso di input che legge da questa connessione aperta. |
JniIdentityHashCode |
La classe |
JniPeerMembers |
La classe |
LastModified |
Restituisce il valore del campo dell'intestazione |
OutputStream |
Restituisce un flusso di output che scrive in questa connessione. |
PeerReference |
La classe |
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à generali delle richieste 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 di questo |
UseCaches |
Restituisce il valore di questo |
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 |
Dispose() |
La classe |
Dispose(Boolean) |
La classe |
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à della richiesta generale denominata per questa connessione. |
GuessContentTypeFromName(String) |
Prova a determinare il tipo di contenuto di un oggetto, in base al componente "file" specificato di un URL. |
GuessContentTypeFromStream(Stream) |
Prova a 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 monitor dell'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 |
ToString() |
Restituisce una rappresentazione di stringa dell'oggetto. (Ereditato da Object) |
UnregisterFromRuntime() |
La classe |
Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
IJavaPeerable.Disposed() |
La classe |
IJavaPeerable.DisposeUnlessReferenced() |
La classe |
IJavaPeerable.Finalized() |
La classe |
IJavaPeerable.JniManagedPeerState |
La classe |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
La classe |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
La classe |
IJavaPeerable.SetPeerReference(JniObjectReference) |
La classe |
Metodi di estensione
JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
JavaCast<TResult>(IJavaObject) |
La classe |
GetJniTypeName(IJavaPeerable) |
La classe |