(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

WebClient-Klasse

Stellt allgemeine Methoden für das Senden von Daten an und das Empfangen von Daten von Ressourcen bereit, die durch einen URI angegeben sind.

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

[ComVisibleAttribute(true)]
public class WebClient : Component

Der WebClient-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeWebClientInitialisiert eine neue Instanz der WebClient-Klasse.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftAllowReadStreamBuffering Veraltet. Ruft einen Wert ab, der angibt, ob die aus der Internetressource gelesenen Daten für eine WebClient-Instanz gepuffert werden sollen, oder legt diesen Wert fest.
Öffentliche EigenschaftAllowWriteStreamBuffering Veraltet. Ruft einen Wert ab, der angibt, ob die in die Internetressource geschriebenen Daten für eine WebClient-Instanz gepuffert werden sollen, oder legt diesen Wert fest.
Öffentliche EigenschaftBaseAddressRuft den Basis-URI für Anforderungen eines WebClient ab oder legt diesen fest.
Öffentliche EigenschaftCachePolicyRuft die Cacherichtlinien der Anwendung für alle von dieser WebClient-Instanz unter Verwendung von WebRequest-Objekten abgerufenen Ressourcen ab oder legt diese fest.
Geschützte EigenschaftCanRaiseEventsRuft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Von Component geerbt.)
Öffentliche EigenschaftContainerRuft den IContainer ab, der die Component enthält. (Von Component geerbt.)
Öffentliche EigenschaftCredentialsRuft die Netzwerkanmeldeinformationen ab, die an den Host gesendet und für die Authentifizierung der Anforderung verwendet werden, oder legt diese fest.
Geschützte EigenschaftDesignModeRuft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Von Component geerbt.)
Öffentliche EigenschaftEncodingRuft die Encoding für den Up- und Download von Zeichenfolgen ab, oder legt diese fest.
Geschützte EigenschaftEventsRuft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Von Component geerbt.)
Öffentliche EigenschaftHeadersRuft eine Auflistung der Name-Wert-Paare für Header auf, die der Anforderung zugeordnet sind, oder legt diese fest.
Öffentliche EigenschaftIsBusyRuft ab, ob gerade eine Webanforderung ausgeführt wird.
Öffentliche EigenschaftProxyRuft den von diesem WebClient-Objekt verwendeten Proxy ab oder legt diesen fest.
Öffentliche EigenschaftQueryStringRuft eine Auflistung der Name-Wert-Paare für Abfragen auf, die der Anforderung zugeordnet sind, oder legt diese fest.
Öffentliche EigenschaftResponseHeadersRuft eine Auflistung der Name-Wert-Paare für Header auf, die der Antwort zugeordnet sind.
Öffentliche EigenschaftSiteRuft die ISite der Component ab oder legt diese fest. (Von Component geerbt.)
Öffentliche EigenschaftUseDefaultCredentialsRuft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeCancelAsyncBricht einen ausstehenden asynchronen Vorgang ab.
Öffentliche MethodeCreateObjRefErstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.)
Öffentliche MethodeDispose() Gibt alle von Component verwendeten Ressourcen frei. (Von Component geerbt.)
Geschützte MethodeDispose(Boolean)Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Von Component geerbt.)
Öffentliche MethodeDownloadData(String)Lädt die Ressourcen als ein Byte Array von der angegebenen URI herunter.
Öffentliche MethodeDownloadData(Uri)Lädt die Ressourcen als ein Byte Array von der angegebenen URI herunter.
Öffentliche MethodeDownloadDataAsync(Uri)Lädt die Ressource als Byte Array aus dem URI herunter, das als asynchroner Vorgang angegeben wird.
Öffentliche MethodeDownloadDataAsync(Uri, Object)Lädt die Ressource als Byte Array aus dem URI herunter, das als asynchroner Vorgang angegeben wird.
Öffentliche MethodeDownloadDataTaskAsync(String)Lädt die Ressource als Byte Array aus dem URI herunter, das als asynchroner Vorgang mithilfe eines Taskobjekts angegeben wird.
Öffentliche MethodeDownloadDataTaskAsync(Uri)Lädt die Ressource als Byte Array aus dem URI herunter, das als asynchroner Vorgang mithilfe eines Taskobjekts angegeben wird.
Öffentliche MethodeDownloadFile(String, String)Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.
Öffentliche MethodeDownloadFile(Uri, String)Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.
Öffentliche MethodeDownloadFileAsync(Uri, String)Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeDownloadFileAsync(Uri, String, Object)Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeDownloadFileTaskAsync(String, String)Lädt die angegebene Ressource in eine lokale Datei als asynchroner Vorgang mithilfe eines Taskobjekts herunter.
Öffentliche MethodeDownloadFileTaskAsync(Uri, String)Lädt die angegebene Ressource in eine lokale Datei als asynchroner Vorgang mithilfe eines Taskobjekts herunter.
Öffentliche MethodeDownloadString(String)Lädt die angeforderte Ressource als String herunter. Die herunterzuladende Ressource wird als String angegeben, der den URI enthält.
Öffentliche MethodeDownloadString(Uri)Lädt die angeforderte Ressource als String herunter. Die herunterzuladende Ressource ist als Uri angegeben.
Öffentliche MethodeDownloadStringAsync(Uri)Lädt die als Uri angegebene Ressource herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeDownloadStringAsync(Uri, Object)Lädt die angegebene Zeichenfolge in die angegebene Ressource herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeDownloadStringTaskAsync(String)Lädt die Ressource als String aus dem URI herunter, das als asynchroner Vorgang mithilfe eines Taskobjekts angegeben wird.
Öffentliche MethodeDownloadStringTaskAsync(Uri)Lädt die Ressource als String aus dem URI herunter, das als asynchroner Vorgang mithilfe eines Taskobjekts angegeben wird.
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor die Component durch den Garbage Collector entfernt wird. (Von Component geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetLifetimeServiceRuft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.)
Geschützte MethodeGetServiceGibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Von Component geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeGetWebRequestGibt ein WebRequest-Objekt für die angegebene Ressource zurück.
Geschützte MethodeGetWebResponse(WebRequest)Gibt den WebResponse für das angegebene WebRequest zurück.
Geschützte MethodeGetWebResponse(WebRequest, IAsyncResult)Gibt die WebResponse für die angegebene WebRequest mit dem angegebenen IAsyncResult zurück.
Öffentliche MethodeInitializeLifetimeServiceRuft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.)
Geschützte MethodeMemberwiseClone()Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeMemberwiseClone(Boolean)Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.)
Geschützte MethodeOnDownloadDataCompletedLöst das DownloadDataCompleted-Ereignis aus.
Geschützte MethodeOnDownloadFileCompletedLöst das DownloadFileCompleted-Ereignis aus.
Geschützte MethodeOnDownloadProgressChangedLöst das DownloadProgressChanged-Ereignis aus.
Geschützte MethodeOnDownloadStringCompletedLöst das DownloadStringCompleted-Ereignis aus.
Geschützte MethodeOnOpenReadCompletedLöst das OpenReadCompleted-Ereignis aus.
Geschützte MethodeOnOpenWriteCompletedLöst das OpenWriteCompleted-Ereignis aus.
Geschützte MethodeOnUploadDataCompletedLöst das UploadDataCompleted-Ereignis aus.
Geschützte MethodeOnUploadFileCompletedLöst das UploadFileCompleted-Ereignis aus.
Geschützte MethodeOnUploadProgressChangedLöst das UploadProgressChanged-Ereignis aus.
Geschützte MethodeOnUploadStringCompletedLöst das UploadStringCompleted-Ereignis aus.
Geschützte MethodeOnUploadValuesCompletedLöst das UploadValuesCompleted-Ereignis aus.
Geschützte MethodeOnWriteStreamClosed Veraltet. Löst das WriteStreamClosed-Ereignis aus.
Öffentliche MethodeOpenRead(String)Öffnet einen lesbaren Stream für die von einer Ressource mit dem als String angegebenen URI heruntergeladenen Daten.
Öffentliche MethodeOpenRead(Uri)Öffnet einen lesbaren Stream für die von einer Ressource mit dem als Uri angegebenen URI heruntergeladenen Daten.
Öffentliche MethodeOpenReadAsync(Uri)Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeOpenReadAsync(Uri, Object)Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeOpenReadTaskAsync(String)Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.
Öffentliche MethodeOpenReadTaskAsync(Uri)Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.
Öffentliche MethodeOpenWrite(String)Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.
Öffentliche MethodeOpenWrite(Uri)Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.
Öffentliche MethodeOpenWrite(String, String)Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.
Öffentliche MethodeOpenWrite(Uri, String)Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.
Öffentliche MethodeOpenWriteAsync(Uri)Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeOpenWriteAsync(Uri, String)Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeOpenWriteAsync(Uri, String, Object)Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeOpenWriteTaskAsync(String)Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.
Öffentliche MethodeOpenWriteTaskAsync(Uri)Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.
Öffentliche MethodeOpenWriteTaskAsync(String, String)Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.
Öffentliche MethodeOpenWriteTaskAsync(Uri, String)Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.
Öffentliche MethodeToString Gibt einen String zurück, der den Namen dieser Componente enthält, sofern vorhanden. Diese Methode sollte nicht überschrieben werden. (Von Component geerbt.)
Öffentliche MethodeUploadData(String, Byte[])Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.
Öffentliche MethodeUploadData(Uri, Byte[])Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.
Öffentliche MethodeUploadData(String, String, Byte[])Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.
Öffentliche MethodeUploadData(Uri, String, Byte[])Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.
Öffentliche MethodeUploadDataAsync(Uri, Byte[])Lädt mit der POST-Methode einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadDataAsync(Uri, String, Byte[])Lädt einen Datenpuffer mit der angegebenen Methode in eine Ressource hoch, die von einem URI identifiziert wird. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadDataAsync(Uri, String, Byte[], Object)Lädt einen Datenpuffer mit der POST-Methode in eine durch einen URI bezeichnete Ressource hoch und verwendet dabei die angegebene Methode und das bezeichnende Token.
Öffentliche MethodeUploadDataTaskAsync(String, Byte[])Lädt einen Datenpuffer hoch, der ein Byte Array an den URI enthält, der mithilfe eines Taskobjekts als asynchroner Vorgang angegeben wird.
Öffentliche MethodeUploadDataTaskAsync(Uri, Byte[])Lädt einen Datenpuffer hoch, der ein Byte Array an den URI enthält, der mithilfe eines Taskobjekts als asynchroner Vorgang angegeben wird.
Öffentliche MethodeUploadDataTaskAsync(String, String, Byte[])Lädt einen Datenpuffer hoch, der ein Byte Array an den URI enthält, der mithilfe eines Taskobjekts als asynchroner Vorgang angegeben wird.
Öffentliche MethodeUploadDataTaskAsync(Uri, String, Byte[])Lädt einen Datenpuffer hoch, der ein Byte Array an den URI enthält, der mithilfe eines Taskobjekts als asynchroner Vorgang angegeben wird.
Öffentliche MethodeUploadFile(String, String)Lädt die angegebene lokale Datei in eine Ressource mit dem angegebenen URI hoch.
Öffentliche MethodeUploadFile(Uri, String)Lädt die angegebene lokale Datei in eine Ressource mit dem angegebenen URI hoch.
Öffentliche MethodeUploadFile(String, String, String)Lädt die angegebene lokale Datei mithilfe der angegebenen Methode in die angegebene Ressource hoch.
Öffentliche MethodeUploadFile(Uri, String, String)Lädt die angegebene lokale Datei mithilfe der angegebenen Methode in die angegebene Ressource hoch.
Öffentliche MethodeUploadFileAsync(Uri, String)Lädt die angegebene lokale Datei mithilfe der POST-Methode in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadFileAsync(Uri, String, String)Lädt die angegebene lokale Datei mithilfe der POST-Methode in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadFileAsync(Uri, String, String, Object)Lädt die angegebene lokale Datei mithilfe der POST-Methode in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadFileTaskAsync(String, String)Lädt die angegebene lokale Datei zu der Ressource mithilfe eines Taskobjekts als asynchroner Vorgang hoch .
Öffentliche MethodeUploadFileTaskAsync(Uri, String)Lädt die angegebene lokale Datei zu der Ressource mithilfe eines Taskobjekts als asynchroner Vorgang hoch .
Öffentliche MethodeUploadFileTaskAsync(String, String, String)Lädt die angegebene lokale Datei zu der Ressource mithilfe eines Taskobjekts als asynchroner Vorgang hoch .
Öffentliche MethodeUploadFileTaskAsync(Uri, String, String)Lädt die angegebene lokale Datei zu der Ressource mithilfe eines Taskobjekts als asynchroner Vorgang hoch .
Öffentliche MethodeUploadString(String, String)Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der POST-Methode hoch.
Öffentliche MethodeUploadString(Uri, String)Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der POST-Methode hoch.
Öffentliche MethodeUploadString(String, String, String)Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der angegebenen Methode hoch.
Öffentliche MethodeUploadString(Uri, String, String)Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der angegebenen Methode hoch.
Öffentliche MethodeUploadStringAsync(Uri, String)Lädt die angegebene Zeichenfolge in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadStringAsync(Uri, String, String)Lädt die angegebene Zeichenfolge in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadStringAsync(Uri, String, String, Object)Lädt die angegebene Zeichenfolge in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadStringTaskAsync(String, String)Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.
Öffentliche MethodeUploadStringTaskAsync(Uri, String)Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.
Öffentliche MethodeUploadStringTaskAsync(String, String, String)Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.
Öffentliche MethodeUploadStringTaskAsync(Uri, String, String)Lädt die angegebene Zeichenfolge der angegebenen Ressource als asynchroner Vorgang mithilfe eines Taskobjekts hoch.
Öffentliche MethodeUploadValues(String, NameValueCollection)Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche MethodeUploadValues(Uri, NameValueCollection)Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche MethodeUploadValues(String, String, NameValueCollection)Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche MethodeUploadValues(Uri, String, NameValueCollection)Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche MethodeUploadValuesAsync(Uri, NameValueCollection)Lädt die Daten in der angegebenen Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadValuesAsync(Uri, String, NameValueCollection)Lädt die Daten in der angegebenen Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche MethodeUploadValuesAsync(Uri, String, NameValueCollection, Object)Lädt die Daten in der angegebenen Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert, und dem Aufrufer wird die Übergabe eines Objekts an die Methode ermöglicht, die beim Abschluss des Vorgangs aufgerufen wird.
Öffentliche MethodeUploadValuesTaskAsync(String, NameValueCollection)Lädt die angegebene Name-Werts-Auflistung zur Ressource hoch, die durch das angegebene URI als asynchroner Vorgang mithilfe eines Taskobjekts identifiziert wird.
Öffentliche MethodeUploadValuesTaskAsync(Uri, NameValueCollection)Lädt die angegebene Name-Werts-Auflistung zur Ressource hoch, die durch das angegebene URI als asynchroner Vorgang mithilfe eines Taskobjekts identifiziert wird.
Öffentliche MethodeUploadValuesTaskAsync(String, String, NameValueCollection)Lädt die angegebene Name-Werts-Auflistung zur Ressource hoch, die durch das angegebene URI als asynchroner Vorgang mithilfe eines Taskobjekts identifiziert wird.
Öffentliche MethodeUploadValuesTaskAsync(Uri, String, NameValueCollection)Lädt die angegebene Name-Werts-Auflistung zur Ressource hoch, die durch das angegebene URI als asynchroner Vorgang mithilfe eines Taskobjekts identifiziert wird.
Zum Seitenanfang

  NameBeschreibung
Öffentliches EreignisDisposed Wird ausgelöst, wenn die Komponente durch einen Aufruf der Dispose-Methode freigegeben wird. (Von Component geerbt.)
Öffentliches EreignisDownloadDataCompletedTritt ein, wenn ein asynchroner Datendownload abgeschlossen wird.
Öffentliches EreignisDownloadFileCompletedTritt ein, wenn ein asynchroner Dateidownload abgeschlossen wird.
Öffentliches EreignisDownloadProgressChangedTritt ein, wenn Daten teilweise oder vollständig erfolgreich über einen asynchronen Download übertragen werden.
Öffentliches EreignisDownloadStringCompletedTritt ein, wenn ein asynchroner Ressourcendownload abgeschlossen wird.
Öffentliches EreignisOpenReadCompletedTritt ein, wenn ein asynchroner Vorgang zum Öffnen eines Streams, der eine Ressource enthält, abgeschlossen wird.
Öffentliches EreignisOpenWriteCompletedTritt ein, wenn ein asynchroner Vorgang zum Öffnen eines Streams, der Daten in eine Ressource schreibt, abgeschlossen wird.
Öffentliches EreignisUploadDataCompletedTritt ein, wenn ein asynchroner Datenupload abgeschlossen wird.
Öffentliches EreignisUploadFileCompletedTritt ein, wenn ein asynchroner Dateiupload abgeschlossen wird.
Öffentliches EreignisUploadProgressChangedTritt ein, wenn Daten teilweise oder vollständig erfolgreich über einen asynchronen Upload übertragen werden.
Öffentliches EreignisUploadStringCompletedTritt ein, wenn ein asynchroner Zeichenfolgenupload abgeschlossen wird.
Öffentliches EreignisUploadValuesCompletedTritt ein, wenn ein asynchroner Upload einer Name-Wert-Auflistung abgeschlossen wird.
Öffentliches EreignisWriteStreamClosed Veraltet. Tritt ein, wenn ein asynchroner Vorgang, um Daten mithilfe eines Schreibstreams in eine Ressource zu schreiben, abgeschlossen wird.
Zum Seitenanfang

Die WebClient-Klasse stellt allgemeine Methoden zum Senden und Empfangen von Daten einer beliebigen lokalen Intranet- oder Internetressource bereit, die mit einem URI gekennzeichnet ist.

Die WebClient-Klasse bietet mithilfe der WebRequest-Klasse Zugriff auf Ressourcen. WebClient -Instanzen können mit einem beliebigen WebRequest-Nachfolger auf Daten zugreifen, der durch die WebRequest.RegisterPrefix-Methode registriert wird.

HinweisHinweis

URIs, die mit den Schemabezeichnern http:, https:, ftp: und file: beginnen, werden von .NET Framework standardmäßig unterstützt.

In der folgenden Tabelle werden WebClient-Methoden für den Upload von Daten in eine Ressource beschrieben.

Methode

Beschreibung

OpenWrite

Ruft einen Stream für das Senden von Daten an die Ressource ab.

OpenWriteAsync

Ruft einen Stream für das Senden von Daten an die Ressource ab, ohne den aufrufenden Thread zu blockieren.

UploadData

Sendet ein Bytearray an die Ressource und gibt ein Byte-Array mit einer beliebigen Antwort zurück.

UploadDataAsync

Sendet ein 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 zurück.

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 zurück.

UploadValuesAsync

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

UploadString

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

UploadStringAsync

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

In der folgenden Tabelle werden WebClient-Methoden für das Herunterladen von Daten aus einer Ressource beschrieben.

Methode

Beschreibung

OpenRead

Gibt die Daten aus einer Ressource als Stream zurück.

OpenReadAsync

Gibt die Daten aus einer Ressource zurück, ohne den aufrufenden Thread zu blockieren.

DownloadData

Lädt Daten aus einer Ressource herunter und gibt ein Byte-Array zurück.

DownloadDataAsync

Lädt Daten aus einer Ressource herunter und gibt ein Byte-Array zurück, 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 herunter, ohne den aufrufenden Thread zu blockieren.

DownloadString

Lädt einen String aus einer Ressource herunter, und gibt einen String zurück.

DownloadStringAsync

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

Asynchrone Vorgänge, die nicht abgeschlossen wurden, können mit der CancelAsync-Methode abgebrochen werden.

WebClient -Instanzen senden in der Standardeinstellung keine optionalen HTTP-Header. Wenn für die Anforderung ein optionaler Header erforderlich ist, müssen Sie den Header der Headers-Auflistung hinzufügen. Um z. B. Abfragen in der Antwort beizubehalten, müssen Sie einen User-Agent-Header hinzufügen. Außerdem geben Server möglicherweise 500 (Interner Serverfehler) zurück, wenn der Header des Benutzer-Agents fehlt.

AllowAutoRedirect wird in WebClient-Instanzen auf true festgelegt.

Hinweise zur Vererbung

Abgeleitete Klassen müssen die Basisklassenimplementierung von WebClient aufrufen, um sicherzustellen, dass die abgeleitete Klasse wie erwartet funktioniert.

Im folgenden Codebeispiel wird der URI einer Ressource erfasst und abgerufen sowie 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 ();
    }
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

  • WebPermission 

    für den Zugriff auf den angeforderten URI oder einen URI, zu dem die Anforderung umgeleitet wurde. Zugeordnete Enumeration: Connect

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft