Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

WebClient-Klasse

 

Veröffentlicht: Oktober 2016

Stellt allgemeine Methoden zum Senden und Empfangen von Daten aus einer Ressource, die von einem URI identifiziert.

Namespace:   System.Net
Assembly:  System (in System.dll)


[ComVisibleAttribute(true)]
public class WebClient : Component

NameBeschreibung
System_CAPS_pubmethodWebClient()

Initialisiert eine neue Instanz der WebClient-Klasse.

NameBeschreibung
System_CAPS_pubpropertyAllowReadStreamBuffering

Veraltet. Ruft ab oder legt einen Wert, der angibt, ob die von der Internetressource für die gelesenen Daten gepuffert eine WebClient Instanz.

System_CAPS_pubpropertyAllowWriteStreamBuffering

Veraltet. Ruft ab oder legt einen Wert, der angibt, ob die Daten in die Internetressource für Puffer eine WebClient Instanz.

System_CAPS_pubpropertyBaseAddress

Ruft ab oder legt den Basis-URI für Anforderungen von einem WebClient.

System_CAPS_pubpropertyCachePolicy

Ruft ab oder legt die Cacherichtlinie für die Anwendung für alle von dieser WebClient-Instanz mit abgerufenen Ressourcen WebRequest Objekte.

System_CAPS_protpropertyCanRaiseEvents

Ruft einen Wert, der angibt, ob die Komponente ein Ereignis auslösen kann.(Geerbt von „Component“.)

System_CAPS_pubpropertyContainer

Ruft die IContainer enthält die Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyCredentials

Ruft ab oder legt die Netzwerkanmeldeinformationen, die an den Host gesendet und zum Authentifizieren der Anforderung verwendet werden.

System_CAPS_protpropertyDesignMode

Ruft einen Wert, der angibt, ob die Component befindet sich derzeit im Entwurfsmodus befindet.(Geerbt von „Component“.)

System_CAPS_pubpropertyEncoding

Ruft die Encoding zum Hochladen und Herunterladen von Zeichenfolgen verwendet.

System_CAPS_protpropertyEvents

Ruft die Liste der Ereignishandler, die mit dieser verknüpft sind Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyHeaders

Ruft ab oder legt eine Auflistung von der Anforderung zugeordneten Name-Wert-Paaren für Header.

System_CAPS_pubpropertyIsBusy

Ruft ab, ob eine Anforderung ausgeführt wird.

System_CAPS_pubpropertyProxy

Ruft ab oder legt den von diesem verwendeten Proxy WebClient Objekt.

System_CAPS_pubpropertyQueryString

Ruft ab oder legt eine Auflistung der Anforderung zugeordneten Name-Wert-Paare für Abfrage fest.

System_CAPS_pubpropertyResponseHeaders

Ruft eine Auflistung von Name-Wert-Paaren für Header der Antwort zugeordnet.

System_CAPS_pubpropertySite

Ruft ab oder legt die ISite von der Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyUseDefaultCredentials

Ruft einen Boolean-Wertes, der steuert, ob die DefaultCredentials mit der Anfrage gesendet werden, ab oder legt diesen fest.

NameBeschreibung
System_CAPS_pubmethodCancelAsync()

Bricht einen ausstehenden asynchronen Vorgang ab.

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodDispose()

Gibt alle vom Component verwendeten Ressourcen frei.(Geerbt von „Component“.)

System_CAPS_protmethodDispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.(Geerbt von „Component“.)

System_CAPS_pubmethodDownloadData(String)

Führt den Download der Ressource als ein Byte Array aus dem angegebenen URI.

System_CAPS_pubmethodDownloadData(Uri)

Führt den Download der Ressource als ein Byte Array aus dem angegebenen URI.

System_CAPS_pubmethodDownloadDataAsync(Uri)

Führt den Download der Ressource als ein Byte Array aus dem URI als asynchronen Vorgang angegeben.

System_CAPS_pubmethodDownloadDataAsync(Uri, Object)

Führt den Download der Ressource als ein Byte Array aus dem URI als asynchronen Vorgang angegeben.

System_CAPS_pubmethodDownloadDataTaskAsync(String)

Führt den Download der Ressource als ein Byte Array aus dem URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodDownloadDataTaskAsync(Uri)

Führt den Download der Ressource als ein Byte Array aus dem URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodDownloadFile(String, String)

Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.

System_CAPS_pubmethodDownloadFile(Uri, String)

Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.

System_CAPS_pubmethodDownloadFileAsync(Uri, String)

Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodDownloadFileAsync(Uri, String, Object)

Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodDownloadFileTaskAsync(String, String)

Lädt die angegebene Ressource in eine lokale Datei als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodDownloadFileTaskAsync(Uri, String)

Lädt die angegebene Ressource in eine lokale Datei als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodDownloadString(String)

Lädt die angeforderte Ressource als eine String. Die herunterzuladende Ressource wird angegeben, wie ein String das den URI enthält.

System_CAPS_pubmethodDownloadString(Uri)

Lädt die angeforderte Ressource als eine String. Die herunterzuladende Ressource wird angegeben, wie ein Uri.

System_CAPS_pubmethodDownloadStringAsync(Uri)

Lädt die Ressource, die als eine Uri. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodDownloadStringAsync(Uri, Object)

Lädt die angegebene Zeichenfolge in die angegebene Ressource. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodDownloadStringTaskAsync(String)

Führt den Download der Ressource als eine String aus dem URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodDownloadStringTaskAsync(Uri)

Führt den Download der Ressource als eine String aus dem URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor die Component durch die Garbage Collection wieder zugänglich gemacht wird.(Geerbt von „Component“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodGetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.(Geerbt von „Component“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_protmethodGetWebRequest(Uri)

Gibt ein WebRequest -Objekt für die angegebene Ressource.

System_CAPS_protmethodGetWebResponse(WebRequest)

Gibt den WebResponse für das angegebene WebRequest zurück.

System_CAPS_protmethodGetWebResponse(WebRequest, IAsyncResult)

Gibt die WebResponse für den angegebenen WebRequest unter Verwendung des angegebenen IAsyncResult.

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekt.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodOnDownloadDataCompleted(DownloadDataCompletedEventArgs)

Löst das DownloadDataCompleted-Ereignis aus.

System_CAPS_protmethodOnDownloadFileCompleted(AsyncCompletedEventArgs)

Löst das DownloadFileCompleted-Ereignis aus.

System_CAPS_protmethodOnDownloadProgressChanged(DownloadProgressChangedEventArgs)

Löst das DownloadProgressChanged-Ereignis aus.

System_CAPS_protmethodOnDownloadStringCompleted(DownloadStringCompletedEventArgs)

Löst das DownloadStringCompleted-Ereignis aus.

System_CAPS_protmethodOnOpenReadCompleted(OpenReadCompletedEventArgs)

Löst das OpenReadCompleted-Ereignis aus.

System_CAPS_protmethodOnOpenWriteCompleted(OpenWriteCompletedEventArgs)

Löst das OpenWriteCompleted-Ereignis aus.

System_CAPS_protmethodOnUploadDataCompleted(UploadDataCompletedEventArgs)

Löst das UploadDataCompleted-Ereignis aus.

System_CAPS_protmethodOnUploadFileCompleted(UploadFileCompletedEventArgs)

Löst das UploadFileCompleted-Ereignis aus.

System_CAPS_protmethodOnUploadProgressChanged(UploadProgressChangedEventArgs)

Löst das UploadProgressChanged-Ereignis aus.

System_CAPS_protmethodOnUploadStringCompleted(UploadStringCompletedEventArgs)

Löst das UploadStringCompleted-Ereignis aus.

System_CAPS_protmethodOnUploadValuesCompleted(UploadValuesCompletedEventArgs)

Löst das UploadValuesCompleted-Ereignis aus.

System_CAPS_protmethodOnWriteStreamClosed(WriteStreamClosedEventArgs)

Veraltet. Löst das WriteStreamClosed-Ereignis aus.

System_CAPS_pubmethodOpenRead(String)

Öffnet ein lesbaren Stream für die Daten, die von einer Ressource mit dem angegebenen als URI heruntergeladenen eine String.

System_CAPS_pubmethodOpenRead(Uri)

Öffnet ein lesbaren Stream für die Daten, die von einer Ressource mit dem angegebenen als URI heruntergeladenen ein Uri

System_CAPS_pubmethodOpenReadAsync(Uri)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource enthält. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodOpenReadAsync(Uri, Object)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource enthält. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodOpenReadTaskAsync(String)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt enthält.

System_CAPS_pubmethodOpenReadTaskAsync(Uri)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt enthält.

System_CAPS_pubmethodOpenWrite(String)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource.

System_CAPS_pubmethodOpenWrite(String, String)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource mit der angegebenen Methode.

System_CAPS_pubmethodOpenWrite(Uri)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource.

System_CAPS_pubmethodOpenWrite(Uri, String)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource mit der angegebenen Methode.

System_CAPS_pubmethodOpenWriteAsync(Uri)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodOpenWriteAsync(Uri, String)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodOpenWriteAsync(Uri, String, Object)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource mit der angegebenen Methode. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodOpenWriteTaskAsync(String)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodOpenWriteTaskAsync(String, String)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodOpenWriteTaskAsync(Uri)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodOpenWriteTaskAsync(Uri, String)

Öffnet einen Stream zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodToString()

Gibt eine String mit dem Namen der Component, sofern vorhanden. Diese Methode darf nicht überschrieben werden.(Geerbt von „Component“.)

System_CAPS_pubmethodUploadData(String, Byte[])

Lädt einen Datenpuffer in eine Ressource von einem URI identifiziert.

System_CAPS_pubmethodUploadData(String, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.

System_CAPS_pubmethodUploadData(Uri, Byte[])

Lädt einen Datenpuffer in eine Ressource von einem URI identifiziert.

System_CAPS_pubmethodUploadData(Uri, String, Byte[])

Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.

System_CAPS_pubmethodUploadDataAsync(Uri, Byte[])

Lädt einen Datenpuffer in eine Ressource mit einem URI, mit der POST-Methode identifiziert. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadDataAsync(Uri, String, Byte[])

Lädt einen Datenpuffer in eine Ressource mit einem URI, der mit der angegebenen Methode identifiziert. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadDataAsync(Uri, String, Byte[], Object)

Lädt einen Datenpuffer in eine Ressource mit einem URI, der mithilfe der angegebenen Methode und das bezeichnende Token identifiziert.

System_CAPS_pubmethodUploadDataTaskAsync(String, Byte[])

Lädt einen Datenpuffer mit einem Byte Array an den URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodUploadDataTaskAsync(String, String, Byte[])

Lädt einen Datenpuffer mit einem Byte Array an den URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodUploadDataTaskAsync(Uri, Byte[])

Lädt einen Datenpuffer mit einem Byte Array an den URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodUploadDataTaskAsync(Uri, String, Byte[])

Lädt einen Datenpuffer mit einem Byte Array an den URI als asynchronen Vorgang mit einem Taskobjekt angegeben.

System_CAPS_pubmethodUploadFile(String, String)

Lädt die angegebene lokale Datei in eine Ressource mit dem angegebenen URI.

System_CAPS_pubmethodUploadFile(String, String, String)

Lädt die angegebene lokale Datei in die angegebene Ressource mit der angegebenen Methode hoch.

System_CAPS_pubmethodUploadFile(Uri, String)

Lädt die angegebene lokale Datei in eine Ressource mit dem angegebenen URI.

System_CAPS_pubmethodUploadFile(Uri, String, String)

Lädt die angegebene lokale Datei in die angegebene Ressource mit der angegebenen Methode hoch.

System_CAPS_pubmethodUploadFileAsync(Uri, String)

Lädt die angegebene lokale Datei in die angegebene Ressource mit der POST-Methode. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadFileAsync(Uri, String, String)

Lädt die angegebene lokale Datei in die angegebene Ressource mit der POST-Methode. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadFileAsync(Uri, String, String, Object)

Lädt die angegebene lokale Datei in die angegebene Ressource mit der POST-Methode. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadFileTaskAsync(String, String)

Lädt die angegebene lokale Datei auf eine Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadFileTaskAsync(String, String, String)

Lädt die angegebene lokale Datei auf eine Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadFileTaskAsync(Uri, String)

Lädt die angegebene lokale Datei auf eine Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadFileTaskAsync(Uri, String, String)

Lädt die angegebene lokale Datei auf eine Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadString(String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mit der POST-Methode.

System_CAPS_pubmethodUploadString(String, String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mit der angegebenen Methode hoch.

System_CAPS_pubmethodUploadString(Uri, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mit der POST-Methode.

System_CAPS_pubmethodUploadString(Uri, String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource mit der angegebenen Methode hoch.

System_CAPS_pubmethodUploadStringAsync(Uri, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadStringAsync(Uri, String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadStringAsync(Uri, String, String, Object)

Lädt die angegebene Zeichenfolge in die angegebene Ressource. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadStringTaskAsync(String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadStringTaskAsync(String, String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadStringTaskAsync(Uri, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadStringTaskAsync(Uri, String, String)

Lädt die angegebene Zeichenfolge in die angegebene Ressource als asynchronen Vorgang mit einem Taskobjekt.

System_CAPS_pubmethodUploadValues(String, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.

System_CAPS_pubmethodUploadValues(String, String, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI mit der angegebenen Methode identifizierte Ressource hoch.

System_CAPS_pubmethodUploadValues(Uri, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.

System_CAPS_pubmethodUploadValues(Uri, String, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI mit der angegebenen Methode identifizierte Ressource hoch.

System_CAPS_pubmethodUploadValuesAsync(Uri, NameValueCollection)

Lädt die Daten in die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadValuesAsync(Uri, String, NameValueCollection)

Lädt die Daten in die angegebene Name-Wert-Auflistung in die durch den angegebenen URI mit der angegebenen Methode identifizierte Ressource hoch. Diese Methode wird den aufrufenden Thread nicht blockiert.

System_CAPS_pubmethodUploadValuesAsync(Uri, String, NameValueCollection, Object)

Lädt die Daten in die angegebene Name-Wert-Auflistung in die durch den angegebenen URI mit der angegebenen Methode identifizierte Ressource hoch. Diese Methode wird den aufrufenden Thread nicht blockiert, und ermöglicht dem Aufrufer, die ein Objekt an die Methode übergeben, die aufgerufen wird, wenn der Vorgang abgeschlossen ist.

System_CAPS_pubmethodUploadValuesTaskAsync(String, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung auf die Ressource, die durch den angegebenen URI als asynchronen Vorgang mit einem Taskobjekt identifiziert.

System_CAPS_pubmethodUploadValuesTaskAsync(String, String, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung auf die Ressource, die durch den angegebenen URI als asynchronen Vorgang mit einem Taskobjekt identifiziert.

System_CAPS_pubmethodUploadValuesTaskAsync(Uri, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung auf die Ressource, die durch den angegebenen URI als asynchronen Vorgang mit einem Taskobjekt identifiziert.

System_CAPS_pubmethodUploadValuesTaskAsync(Uri, String, NameValueCollection)

Lädt die angegebene Name-Wert-Auflistung auf die Ressource, die durch den angegebenen URI als asynchronen Vorgang mit einem Taskobjekt identifiziert.

NameBeschreibung
System_CAPS_pubeventDisposed

Tritt auf, wenn die Komponente, durch einen Aufruf freigegeben wird der Dispose Methode.(Geerbt von „Component“.)

System_CAPS_pubeventDownloadDataCompleted

Tritt auf, wenn ein asynchroner Datendownload abgeschlossen ist.

System_CAPS_pubeventDownloadFileCompleted

Tritt auf, wenn ein asynchroner Dateidownload abgeschlossen wird.

System_CAPS_pubeventDownloadProgressChanged

Tritt auf, wenn einige oder alle Daten erfolgreich über einen asynchronen Download übertragen.

System_CAPS_pubeventDownloadStringCompleted

Tritt auf, wenn ein asynchroner Ressourcendownload abgeschlossen ist.

System_CAPS_pubeventOpenReadCompleted

Tritt bei Abschluss eines asynchronen Vorgangs zum Öffnen eines Datenstroms, der eine Ressource enthält.

System_CAPS_pubeventOpenWriteCompleted

Tritt bei Abschluss eines asynchronen Vorgangs zum Öffnen eines Streams zum Schreiben von Daten auf eine Ressource.

System_CAPS_pubeventUploadDataCompleted

Tritt auf, wenn ein asynchroner Datenupload abgeschlossen wird.

System_CAPS_pubeventUploadFileCompleted

Tritt auf, wenn ein asynchrone Datei-Upload-Vorgang abgeschlossen ist.

System_CAPS_pubeventUploadProgressChanged

Tritt auf, wenn einige oder alle Daten erfolgreich über einen asynchronen Upload übertragen.

System_CAPS_pubeventUploadStringCompleted

Tritt auf, wenn ein asynchroner Zeichenfolge-Upload-Vorgang abgeschlossen ist.

System_CAPS_pubeventUploadValuesCompleted

Tritt auf, wenn ein asynchroner Upload einer Name-Wert-Auflistung abgeschlossen ist.

System_CAPS_pubeventWriteStreamClosed

Veraltet. Tritt auf, wenn ein asynchroner Vorgang zum Schreiben von Daten in eine Ressource mit einem Stream schreiben geschlossen wird.

Die WebClient -Klasse stellt allgemeine Methoden zum Senden und Empfangen von Daten einer beliebigen lokalen, Intranet oder Internet-Ressource, die von einem URI identifiziert.

Die WebClient -Klasse verwendet die WebRequest Klasse, um den Zugriff auf Ressourcen bereitzustellen. WebClient Instanzen können Datenzugriff mit WebRequest Nachfolger registriert die WebRequest.RegisterPrefix Methode.

System_CAPS_noteHinweis

Standardmäßig unterstützt die .NET Framework URIs, die mit http:, https:, ftp:, und file: Schema Bezeichner.

Die folgende Tabelle beschreibt WebClient Methoden zum Hochladen von Daten auf eine Ressource.

Methode

Beschreibung

OpenWrite

Ruft eine Stream zum Senden von Daten an die Ressource verwendet.

OpenWriteAsync

Ruft eine Stream verwendet, um Daten an die Ressource senden, ohne den aufrufenden Thread zu blockieren.

UploadData

Sendet ein Bytearray an die Ressource und gibt ein Byte Array mit einer beliebigen Antwort.

UploadDataAsync

Sendet eine Byte Array an die Ressource, ohne den aufrufenden Thread zu blockieren.

UploadFile

Sendet eine lokale Datei an die Ressource und gibt ein Byte Array mit einer beliebigen Antwort.

UploadFileAsync

Sendet eine lokale Datei an die Ressource, ohne den aufrufenden Thread zu blockieren.

UploadValues

Sendet eine NameValueCollection an die Ressource und gibt ein Byte Array mit einer beliebigen Antwort.

UploadValuesAsync

Sendet eine NameValueCollection an die Ressource und gibt ein Byte Array mit einer beliebigen Antwort ohne den aufrufenden Thread zu blockieren.

UploadString

Sendet eine String an die Ressource, ohne den aufrufenden Thread zu blockieren.

UploadStringAsync

Sendet eine String an die Ressource, ohne den aufrufenden Thread zu blockieren.

Die folgende Tabelle beschreibt WebClient Methoden zum Herunterladen von Daten aus einer Ressource.

Methode

Beschreibung

OpenRead

Gibt die Daten aus einer Ressource als ein Stream.

OpenReadAsync

Die Daten zurückgegeben aus einer Ressource, ohne den aufrufenden Thread zu blockieren.

DownloadData

Lädt Daten aus einer Ressource herunter und gibt ein Byte Array.

DownloadDataAsync

Lädt Daten aus einer Ressource herunter und gibt ein Byte Array, ohne den aufrufenden Thread zu blockieren.

DownloadFile

Lädt Daten aus einer Ressource in eine lokale Datei herunter.

DownloadFileAsync

Lädt Daten aus einer Ressource in eine lokale Datei, ohne den aufrufenden Thread zu blockieren.

DownloadString

Lädt eine String aus einer Ressource und gibt ein String.

DownloadStringAsync

Lädt eine String aus einer Ressource, ohne den aufrufenden Thread zu blockieren.

Sie können die CancelAsync Methode, um asynchrone Vorgänge abzubrechen, die nicht abgeschlossen wurden.

Ein WebClient Instanz sendet keine optionalen HTTP-Header standardmäßig. Wenn die Anforderung einen optionalen Header erforderlich ist, müssen Sie der Kopfzeile hinzufügen der Headers Auflistung. Um Abfragen in der Antwort beizubehalten, müssen Sie z. B. einen Benutzer-Agent-Header hinzufügen. Darüber hinaus können Server 500 (Interner Serverfehler) zurück, wenn der Benutzer-Agent-Header fehlt.

AllowAutoRedirect Wert true in WebClient Instanzen.

Hinweise für Vererber:

Abgeleitete Klassen sollten die Implementierung der Basisklasse aufrufen WebClient um sicherzustellen, dass die abgeleitete Klasse wie erwartet funktioniert.

Im folgenden Codebeispiel wird der URI einer Ressource, abgerufen und die Antwort angezeigt.

using System;
using System.Net;
using System.IO;

public class Test
{
    public static void Main (string[] args)
    {
        if (args == null || args.Length == 0)
        {
            throw new ApplicationException ("Specify the URI of the resource to retrieve.");
        }
        WebClient client = new WebClient ();

        // Add a user agent header in case the 
        // requested URI contains a query.

        client.Headers.Add ("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)");

        Stream data = client.OpenRead (args[0]);
        StreamReader reader = new StreamReader (data);
        string s = reader.ReadToEnd ();
        Console.WriteLine (s);
        data.Close ();
        reader.Close ();
    }
}

WebPermission

to access the requested URI or any URI that the request is redirected to. Associated enumeration: F:System.Net.NetworkAccess.Connect.

.NET Framework
Verfügbar seit 1.1
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: