URLConnection Classe

Definizione

Spazio dei nomi:: Java.Net

Assembly:: Mono.Android.dll

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à: Object

Object
URLConnection

Derivato: Java.Net.HttpURLConnection

Java.Net.JarURLConnection

Attributi: RegisterAttribute

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/th>openConnection()<><>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. </ol>

I parametri di installazione vengono modificati usando i metodi seguenti: <ul><li>setAllowUserInteraction<>setDoInput<li>setDoOutput<li>setIfModifiedSince<>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>getContentLength<>getContentType<>getDate<>getExpiration<>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 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.

per java.net.URLConnection.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Costruttori

Nome	Descrizione
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à

Nome	Descrizione
AllowUserInteraction	Restituisce il valore del `allowUserInteraction` campo per questo oggetto. -oppure- Impostare il valore del `allowUserInteraction` campo di questo `URLConnection`oggetto .
Class	Restituisce la classe di runtime di questo `Object`oggetto . (Ereditato da Object)
Connected	Se `false`, questo oggetto connessione non ha creato un collegamento di comunicazione all'URL specificato.
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 `content-encoding` .
ContentLength	Restituisce il valore del campo dell'intestazione `content-length` .
ContentLengthLong	Restituisce il valore del `content-length` campo di intestazione come long.
ContentType	Restituisce il valore del campo dell'intestazione `content-type` .
Date	Restituisce il valore del campo dell'intestazione `date` .
DefaultAllowUserInteraction	Restituisce il valore predefinito del `allowUserInteraction` campo. -oppure- Imposta il valore predefinito del `allowUserInteraction` campo per tutti gli oggetti futuri `URLConnection` sul valore specificato.
DefaultUseCaches	Restituisce il valore predefinito del flag di `URLConnection` un `useCaches`oggetto . -oppure- Imposta il valore predefinito del `useCaches` campo sul valore specificato.
DoInput	Restituisce il valore del `URLConnection`flag .`doInput` -oppure- Imposta il valore del `doInput` campo per questo `URLConnection` sul valore specificato.
DoOutput	Restituisce il valore del `URLConnection`flag .`doOutput` -oppure- Imposta il valore del `doOutput` campo per questo `URLConnection` sul valore specificato.
Expiration	Restituisce il valore del campo dell'intestazione `expires` .
FileNameMap	Restituisce un'implementazione `FileNameMap` adatta per indovinare un tipo di contenuto in base al componente "file" di un URL. -oppure- Imposta FileNameMap.
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 `ifModifiedSince` . -oppure- Imposta il valore del `ifModifiedSince` campo di questo `URLConnection` sul valore specificato.
InputStream	Restituisce un flusso di input che legge da questa connessione aperta.
JniIdentityHashCode	Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object)
JniPeerMembers	La classe `URLConnection` astratta è la superclasse di tutte le classi che rappresentano un collegamento di comunicazione tra l'applicazione e un URL.
LastModified	Restituisce il valore del campo dell'intestazione `last-modified` .
OutputStream	Restituisce un flusso di output che scrive in questa connessione.
PeerReference	Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object)
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 `URLConnectionURL` campo.
UseCaches	Restituisce il valore di questo `URLConnectionuseCaches` campo. -oppure- Imposta il valore del `useCaches` campo di questo `URLConnection` sul valore specificato.

Metodi

Nome	Descrizione
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 `URLConnection` astratta è la superclasse di tutte le classi che rappresentano un collegamento di comunicazione tra l'applicazione e un URL.
Dispose()	Rilascia le risorse contenute in questo peer Java. (Ereditato da Object)
Dispose(Boolean)	Rilascia le risorse contenute in questo peer Java. (Ereditato da Object)
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 di codice hash per l'oggetto . (Ereditato da Object)
GetHeaderField(Int32)	Restituisce il valore per il `n`campo intestazione sup<>/sup<.>
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 `n`campo intestazione sup<>/sup<.>
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 `ContentHandlerFactory` di un'applicazione.
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>()	Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object)
ToString()	Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object)
UnregisterFromRuntime()	Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object)
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

Nome	Descrizione
IJavaPeerable.Disposed()	Notifica al runtime di interoperabilità che il peer gestito è stato eliminato. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Rilascia questo Java peer a meno che non venga conservato da un altro riferimento gestito. (Ereditato da Object)
IJavaPeerable.Finalized()	Notifica al runtime di interoperabilità che il peer gestito è stato finalizzato. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Ottiene lo stato che descrive la relazione tra questo peer gestito e il relativo riferimento JNI. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Imposta il codice hash dell'identità di interoperabilità per questo Java peer. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Imposta lo stato peer gestito e JNI per questo peer Java. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Imposta il riferimento all'oggetto JNI usato da questo peer gestito. (Ereditato da Object)

Metodi di estensione

Nome	Descrizione
GetJniTypeName(IJavaPeerable)	Ottiene il nome JNI del tipo dell'istanza `self`di .
JavaAs<TResult>(IJavaPeerable)	Provare a digitare `selfTResult`, verificando che la coercizione sia valida sul lato Java.
JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo di tipo controllato dal runtime Android.
JavaCast<TResult>(IJavaObject)	La classe `URLConnection` astratta è la superclasse di tutte le classi che rappresentano un collegamento di comunicazione tra l'applicazione e un URL.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Provare a digitare `selfTResult`, verificando che la coercizione sia valida sul lato Java.

Si applica a