URLConnection Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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
><<setDoOutput
setIfModifiedSince
<>/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><getHeaderField
ligetInputStream
<><>getOutputStream
li/ul>
Auf bestimmte Kopfzeilenfelder wird häufig zugegriffen. Die Methoden: <ul><li>getContentEncoding
<li li>getLastModifed
><getExpiration
getDate
<>><<getContentLength
getContentType
<>/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 |
Class |
Gibt die Laufzeitklasse dieses Werts |
Connected |
Wenn |
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 |
ContentLength |
Gibt den Wert des |
ContentLengthLong |
Gibt den Wert des |
ContentType |
Gibt den Wert des |
Date |
Gibt den Wert des |
DefaultAllowUserInteraction |
Gibt den Standardwert des |
DefaultUseCaches |
Gibt den Standardwert eines Flags |
DoInput |
Gibt den Wert dieses |
DoOutput |
Gibt den Wert dieses |
Expiration |
Gibt den Wert des |
FileNameMap |
Gibt eine Implementierung zurück, die für das |
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 |
InputStream |
Gibt einen Eingabedatenstrom zurück, der aus dieser geöffneten Verbindung gelesen wird. |
JniIdentityHashCode |
Die abstrakte Klasse |
JniPeerMembers |
Die abstrakte Klasse |
LastModified |
Gibt den Wert des |
OutputStream |
Gibt einen Ausgabedatenstrom zurück, der in diese Verbindung schreibt. |
PeerReference |
Die abstrakte Klasse |
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 |
UseCaches |
Gibt den Wert dieses |
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 |
Dispose() |
Die abstrakte Klasse |
Dispose(Boolean) |
Die abstrakte Klasse |
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 |
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 |
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 |
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 |
ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
UnregisterFromRuntime() |
Die abstrakte Klasse |
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 |
IJavaPeerable.DisposeUnlessReferenced() |
Die abstrakte Klasse |
IJavaPeerable.Finalized() |
Die abstrakte Klasse |
IJavaPeerable.JniManagedPeerState |
Die abstrakte Klasse |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Die abstrakte Klasse |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Die abstrakte Klasse |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Die abstrakte Klasse |
Erweiterungsmethoden
JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
JavaCast<TResult>(IJavaObject) |
Die abstrakte Klasse |
GetJniTypeName(IJavaPeerable) |
Die abstrakte Klasse |