Freigeben über


URLConnection Klasse

Definition

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

[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
Vererbung
URLConnection
Abgeleitet
Attribute

Hinweise

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen. Instanzen dieser Klasse können sowohl zum Lesen aus als auch zum Schreiben in die Ressource verwendet werden, auf die von der URL verwiesen wird. Im Allgemeinen ist das Erstellen einer Verbindung mit einer URL ein mehrstufiger Prozess:

<zentrieren><Tabellenrahmen=2 summary="Beschreibt den Prozess zum Erstellen einer Verbindung mit einer URL: openConnection() und connect() im Laufe der Zeit."><tr><th<openConnection()>/th></thconnect()<>/th></tr tr<><>td>Bearbeiten Sie Parameter, die sich auf die Verbindung mit der Remoteressource auswirken.</td td><>Interagiere mit der Ressource; Abfragekopffelder und -inhalte.</td></tr></table> ----------------------------> <br>Zeit</Mitte>

<ol><li>Das Verbindungsobjekt wird durch Aufrufen der openConnection Methode für eine URL erstellt. <li>Die Setupparameter und allgemeine Anforderungseigenschaften werden bearbeitet. <li>Die tatsächliche Verbindung mit dem Remoteobjekt wird mithilfe der connect Methode hergestellt. <li>Das Remoteobjekt wird verfügbar. Auf die Kopfzeilenfelder und den Inhalt des Remoteobjekts kann zugegriffen werden. </ol>

Die Setupparameter werden mit den folgenden Methoden geändert: <ul><li>setAllowUserInteraction<li lisetDoInput<>li>setUseCaches><<setDoOutputsetIfModifiedSince<>/ul>

und die allgemeinen Anforderungseigenschaften werden mit der Methode geändert: <ul><li>setRequestProperty</ul>

Standardwerte für die AllowUserInteraction und Die Parameter können mit den Methoden setDefaultAllowUserInteraction und UseCaches setDefaultUseCaches.

Jede der oben genannten set Methoden weist eine entsprechende get Methode auf, um den Wert des Parameters oder der allgemeinen Anforderungseigenschaft abzurufen. Die spezifischen Parameter und allgemeinen Anforderungseigenschaften, die anwendbar sind, sind protokollspezifisch.

Die folgenden Methoden werden verwendet, um auf die Kopfzeilenfelder und den Inhalt zuzugreifen, nachdem die Verbindung mit dem Remoteobjekt hergestellt wurde: <ul><li>getContent<li><getHeaderFieldligetInputStream<><>getOutputStream li/ul>

Auf bestimmte Kopfzeilenfelder wird häufig zugegriffen. Die Methoden: <ul><li>getContentEncoding<li li>getLastModifed><getExpirationgetDate<>><<getContentLengthgetContentType<>/ul>

Ermöglichen Sie den bequemen Zugriff auf diese Felder. Die getContentType Methode wird von der getContent Methode verwendet, um den Typ des Remoteobjekts zu bestimmen. Unterklassen können es praktisch finden, die getContentType Methode außer Kraft zu setzen.

Im allgemeinen können alle Parameter vor der Verbindung und allgemeine Anforderungseigenschaften ignoriert werden: die Parameter vor der Verbindung und die Anforderungseigenschaften werden standardmäßig für sensible Werte festgelegt. Für die meisten Clients dieser Schnittstelle gibt es nur zwei interessante Methoden: getInputStream und getContent, die in der URL Klasse durch Komfortmethoden gespiegelt werden.

Weitere Informationen zu den Anforderungseigenschaften und Kopfzeilenfeldern einer http Verbindung finden Sie unter: <blockquote>

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

</blockquote>

Das Aufrufen der close() Methoden auf dem InputStream oder OutputStream nach URLConnection einer Anforderung kann Netzwerkressourcen, die dieser Instanz zugeordnet sind, freigeben, es sei denn, bestimmte Protokollspezifikationen geben unterschiedliche Verhaltensweisen dafür an.

In JDK1.0 hinzugefügt.

Java-Dokumentation für java.net.URLConnection.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

URLConnection(IntPtr, JniHandleOwnership)

Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

URLConnection(URL)

Erstellt eine URL-Verbindung mit der angegebenen URL.

Eigenschaften

AllowUserInteraction

Gibt den Wert des allowUserInteraction Felds für dieses Objekt zurück. -oder- Legen Sie den Wert des allowUserInteraction Felds dieses URLConnectionFelds fest.

Class

Gibt die Laufzeitklasse dieses Werts Objectzurück.

(Geerbt von Object)
Connected

Wenn falsedieses Verbindungsobjekt keinen Kommunikationslink zu der angegebenen URL erstellt hat.

ConnectTimeout

Gibt die Einstellung für das Verbindungstimeout zurück. -or- Legt einen angegebenen Timeoutwert in Millisekunden fest, der beim Öffnen einer Kommunikationsverknüpfung mit der Ressource verwendet werden soll, auf die von dieser URLConnection verwiesen wird.

Content

Ruft den Inhalt dieser URL-Verbindung ab.

ContentEncoding

Gibt den Wert des content-encoding Kopfzeilenfelds zurück.

ContentLength

Gibt den Wert des content-length Kopfzeilenfelds zurück.

ContentLengthLong

Gibt den Wert des content-length Kopfzeilenfelds als lange zurück.

ContentType

Gibt den Wert des content-type Kopfzeilenfelds zurück.

Date

Gibt den Wert des date Kopfzeilenfelds zurück.

DefaultAllowUserInteraction

Gibt den Standardwert des allowUserInteraction Felds zurück. -or- Legt den Standardwert des allowUserInteraction Felds für alle zukünftigen URLConnection Objekte auf den angegebenen Wert fest.

DefaultUseCaches

Gibt den Standardwert eines Flags useCaches zurückURLConnection. -or- Legt den Standardwert des useCaches Felds auf den angegebenen Wert fest.

DoInput

Gibt den Wert dieses URLConnectionFlags doInput zurück. -or- Legt den Wert des doInput Felds URLConnection dafür auf den angegebenen Wert fest.

DoOutput

Gibt den Wert dieses URLConnectionFlags doOutput zurück. -or- Legt den Wert des doOutput Felds URLConnection dafür auf den angegebenen Wert fest.

Expiration

Gibt den Wert des expires Kopfzeilenfelds zurück.

FileNameMap

Gibt eine Implementierung zurück, die für das FileNameMap Erraten eines Inhaltstyps basierend auf der Komponente "Datei" einer URL geeignet ist. -or- Legt die FileNameMap fest.

Handle

Das Handle für die zugrunde liegende Android-Instanz.

(Geerbt von Object)
HeaderFields

Gibt eine nicht veränderbare Zuordnung der Kopfzeilenfelder zurück.

IfModifiedSince

Gibt den Wert des Felds ifModifiedSince dieses Objekts zurück. -or- Legt den Wert des ifModifiedSince Felds dieses URLConnection Werts auf den angegebenen Wert fest.

InputStream

Gibt einen Eingabedatenstrom zurück, der aus dieser geöffneten Verbindung gelesen wird.

JniIdentityHashCode

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
JniPeerMembers

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

LastModified

Gibt den Wert des last-modified Kopfzeilenfelds zurück.

OutputStream

Gibt einen Ausgabedatenstrom zurück, der in diese Verbindung schreibt.

PeerReference

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
Permission

Gibt ein Berechtigungsobjekt zurück, das die erforderliche Berechtigung darstellt, um die verbindung durch dieses Objekt dargestellt zu machen.

ReadTimeout

Gibt die Einstellung für das Lesetimeout zurück. -oder- Legt das Lesetimeout auf ein angegebenes Timeout in Millisekunden fest.

RequestProperties

Gibt eine nicht veränderbare Zuordnung allgemeiner Anforderungseigenschaften für diese Verbindung zurück.

ThresholdClass

Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

ThresholdType

Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Url

Die URL stellt das Remoteobjekt im World Wide Web dar, mit dem diese Verbindung geöffnet wird.

URL

Gibt den Wert dieses URLConnectionFelds URL zurück.

UseCaches

Gibt den Wert dieses URLConnectionFelds useCaches zurück. -or- Legt den Wert des useCaches Felds dieses URLConnection Werts auf den angegebenen Wert fest.

Methoden

AddRequestProperty(String, String)

Fügt eine allgemeine Anforderungseigenschaft hinzu, die durch ein Schlüsselwertpaar angegeben wird.

Clone()

Erstellt und gibt eine Kopie dieses Objekts zurück.

(Geerbt von Object)
Connect()

Öffnet eine Kommunikationsverknüpfung zu der Ressource, auf die von dieser URL verwiesen wird, wenn eine solche Verbindung noch nicht hergestellt wurde.

ConnectAsync()

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

Dispose()

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
Dispose(Boolean)

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
Equals(Object)

Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist.

(Geerbt von Object)
GetContent(Class[])

Ruft den Inhalt dieser URL-Verbindung ab.

GetDefaultRequestProperty(String)
Veraltet.

Gibt den Wert der Standardanforderungseigenschaft zurück.

GetHashCode()

Gibt einen Hashcodewert für das Objekt zurück.

(Geerbt von Object)
GetHeaderField(Int32)

Gibt den Wert für das n<Sup-th<>/sup-Kopfzeilenfeld> zurück.

GetHeaderField(String)

Gibt den Wert des benannten Kopfzeilenfelds zurück.

GetHeaderFieldDate(String, Int64)

Gibt den Wert des benannten Felds zurück, das als Datum analysiert wurde.

GetHeaderFieldInt(String, Int32)

Gibt den Wert des benannten Felds zurück, das als Zahl analysiert wird.

GetHeaderFieldKey(Int32)

Gibt den Schlüssel für das n<Sup>-/<Sup-Kopfzeilenfeld> zurück.

GetHeaderFieldLong(String, Int64)

Gibt den Wert des benannten Felds zurück, das als Zahl analysiert wird.

GetRequestProperty(String)

Gibt den Wert der benannten allgemeinen Anforderungseigenschaft für diese Verbindung zurück.

GuessContentTypeFromName(String)

Versucht, den Inhaltstyp eines Objekts basierend auf der angegebenen "Datei"-Komponente einer URL zu ermitteln.

GuessContentTypeFromStream(Stream)

Versucht, den Typ eines Eingabedatenstroms basierend auf den Zeichen am Anfang des Eingabedatenstroms zu ermitteln.

JavaFinalize()

Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind.

(Geerbt von Object)
Notify()

Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet.

(Geerbt von Object)
NotifyAll()

Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten.

(Geerbt von Object)
SetContentHandlerFactory(IContentHandlerFactory)

Legt die ContentHandlerFactory Anwendung fest.

SetDefaultRequestProperty(String, String)
Veraltet.

Legt den Standardwert einer allgemeinen Anforderungseigenschaft fest.

SetHandle(IntPtr, JniHandleOwnership)

Legt die Handle-Eigenschaft fest.

(Geerbt von Object)
SetRequestProperty(String, String)

Legt die allgemeine Anforderungseigenschaft fest.

ToArray<T>()

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolgendarstellung des Objekts zurück.

(Geerbt von Object)
UnregisterFromRuntime()

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
Wait()

Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<><

(Geerbt von Object)
Wait(Int64, Int32)

Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist.

(Geerbt von Object)
Wait(Int64)

Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
IJavaPeerable.Finalized()

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
IJavaPeerable.JniManagedPeerState

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

(Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)

Führt eine android-laufzeitgecheckte Typkonvertierung aus.

JavaCast<TResult>(IJavaObject)

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

GetJniTypeName(IJavaPeerable)

Die abstrakte Klasse URLConnection ist die Superklasse aller Klassen, die eine Kommunikationsverbindung zwischen der Anwendung und einer URL darstellen.

Gilt für: