URL 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 URL rappresenta un localizzatore di risorse uniformi, un puntatore a una "risorsa" nel 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- Ereditarietà
- Attributi
- Implementazioni
Commenti
La classe URL rappresenta un localizzatore di risorse uniformi, un puntatore a una "risorsa" nel World Wide Web. Una risorsa può essere semplice come un file o una directory oppure può essere un riferimento a un oggetto più complesso, ad esempio una query a un database o a un motore di ricerca. Altre informazioni sui tipi di URL e sui relativi formati sono disponibili in: Tipi di URLhttp://web.archive.org/web/20051219043731/http://archive.ncsa.uiuc.edu/SDG/Software/Mosaic/Demo/url-primer.html
In generale, un URL può essere suddiviso in diverse parti. Si consideri l'esempio seguente: <blockquote>
http://www.example.com/docs/resource1.html
</blockquote>
L'URL precedente indica che il protocollo da usare è http (HyperText Transfer Protocol) e che le informazioni si trovano in un computer host denominato www.example.com. Le informazioni sul computer host sono denominate /docs/resource1.html. Il significato esatto di questo nome nel computer host è dipendente dal protocollo e dipendente dall'host. Le informazioni si trovano normalmente in un file, ma potrebbero essere generate in tempo reale. Questo componente dell'URL è denominato componente del percorso .
Un URL può facoltativamente specificare una "porta", ovvero il numero di porta a cui viene stabilita la connessione TCP nel computer host remoto. Se la porta non è specificata, viene invece usata la porta predefinita per il protocollo. Ad esempio, la porta predefinita per http è 80. È possibile specificare una porta alternativa come: <blockquote>
http://www.example.com:1080/docs/resource1.html
</blockquote>
La sintassi di URL è definita da RFC 2396: URI (Uniform Resource Identifiers): sintassi genericahttp://www.ietf.org/rfc/rfc2396.txt, modificata da RFC 2732: formato per gli indirizzi IPv6 letterali negli URLhttp://www.ietf.org/rfc/rfc2732.txt. Il formato di indirizzo IPv6 letterale supporta anche scope_ids. La sintassi e l'utilizzo di scope_ids sono descritti qui.
A un URL può essere stato aggiunto un "frammento", noto anche come "ref" o "reference". Il frammento è indicato dal carattere segno tagliente "#" seguito da più caratteri. Ad esempio, <blockquote>
http://java.sun.com/index.html#chapter1
</blockquote>
Questo frammento non fa tecnicamente parte dell'URL. Invece, indica che dopo il recupero della risorsa specificata, l'applicazione è in particolare interessata a quella parte del documento che contiene il tag chapter1 associato. Il significato di un tag è specifico della risorsa.
Un'applicazione può anche specificare un "URL relativo", che contiene solo informazioni sufficienti per raggiungere la risorsa rispetto a un altro URL. Gli URL relativi vengono spesso usati all'interno delle pagine HTML. Ad esempio, se il contenuto dell'URL: <blockquote>
http://java.sun.com/index.html
</blockquote> contenuto all'interno dell'URL relativo: <blockquote>
FAQ.html
</blockquote> sarebbe una sintassi abbreviata per: <blockquote>
http://java.sun.com/FAQ.html
</blockquote>
L'URL relativo non deve specificare tutti i componenti di un URL. Se manca il protocollo, il nome host o il numero di porta, il valore viene ereditato dall'URL completamente specificato. È necessario specificare il componente file. Il frammento facoltativo non viene ereditato.
La classe URL non codifica o decodifica alcun componente URL in base al meccanismo di escape definito in RFC2396. È responsabilità del chiamante codificare tutti i campi, che devono essere preceduti da escape prima della chiamata dell'URL e anche decodificare eventuali campi di escape restituiti dall'URL. Inoltre, poiché l'URL non conosce l'escape degli URL, non riconosce l'equivalenza tra la forma codificata o decodificata dello stesso URL. Ad esempio, i due URL:<br>
http://foo.com/hello world/ and http://foo.com/hello%20world
sarebbe considerato non uguale l'uno all'altro.
Si noti che la classe esegue l'escape java.net.URI dei relativi campi componente in determinate circostanze. Il modo consigliato per gestire la codifica e la decodifica degli URL consiste nell'usare java.net.URIe per eseguire la conversione tra queste due classi usando #toURI() e URI#toURL().
Le URLEncoder classi e URLDecoder possono essere usate anche, ma solo per la codifica dei moduli HTML, che non corrisponde allo schema di codifica definito in RFC2396.
Aggiunta in JDK1.0.
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 |
|---|---|
| URL(String, String, Int32, String, URLStreamHandler) |
Crea un |
| URL(String, String, Int32, String) |
Crea un |
| URL(String, String, String) |
Crea un URL dal nome, |
| URL(String) |
Crea un |
| URL(URL, String, URLStreamHandler) |
Crea un URL analizzando la specifica specificata con il gestore specificato all'interno di un contesto specificato. |
| URL(URL, String) |
Crea un URL analizzando la specifica specificata all'interno di un contesto specificato. |
Proprietà
| Nome | Descrizione |
|---|---|
| Authority |
Ottiene la parte dell'autorità di questo |
| Class |
Restituisce la classe di runtime di questo |
| Content |
Ottiene il contenuto di questo URL. |
| DefaultPort |
Ottiene il numero di porta predefinito del protocollo associato a questo |
| File |
Ottiene il nome di file dell'oggetto |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| Host |
Ottiene il nome host di questo |
| JniIdentityHashCode |
Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| JniManagedPeerState |
La classe |
| JniPeerMembers |
La classe |
| Path |
Ottiene la parte del percorso dell'oggetto |
| PeerReference |
Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object) |
| Port |
Ottiene il numero di porta dell'oggetto |
| Protocol |
Ottiene il nome del protocollo dell'oggetto |
| Query |
Ottiene la parte della query di questo |
| Ref |
Ottiene l'ancoraggio (noto anche come "riferimento") di questo |
| ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object) |
| ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object) |
| UserInfo |
Ottiene la parte userInfo di questo |
Metodi
| Nome | Descrizione |
|---|---|
| Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
La classe |
| 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) |
| DisposeUnlessReferenced() |
La classe |
| Equals(Object) |
La classe |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| GetContent(Class[]) |
Ottiene il contenuto di questo URL. |
| GetHashCode() |
Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object) |
| 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) |
| OpenConnection() |
Restituisce un'istanza |
| OpenConnection(Proxy) |
Uguale a |
| OpenStream() |
Apre una connessione a questo |
| SameFile(URL) |
Confronta due URL, escluso il componente frammento. |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
La classe |
| SetURLStreamHandlerFactory(IURLStreamHandlerFactory) |
Imposta l'oggetto di |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToExternalForm() |
Costruisce una rappresentazione di stringa di questo |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| ToURI() |
Restituisce un |
| 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() |
La classe |
| IJavaPeerable.Finalized() |
La classe |
| IJavaPeerable.JniObjectReferenceControlBlock |
La classe |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
La classe |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
La classe |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
La classe |
| IJavaPeerable.UnregisterFromRuntime() |
La classe |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
La classe |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |