Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
0 von 2 fanden dies hilfreich - Dieses Thema bewerten.

WebClient-Klasse

.NET Framework 4

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Net.WebClient

Namespace:  System.Net
Assembly:  System (in System.dll)
C#
C++
F#
VB
Kopieren 
[ComVisibleAttribute(true)]
public class WebClient : Component

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

  Name Beschreibung
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif WebClient Initialisiert eine neue Instanz der WebClient-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft tt0f69eh.PortableClassLibrary(de-de,VS.100).gif BaseAddress Ruft den Basis-URI für Anforderungen eines WebClient ab oder legt diesen fest.
Öffentliche Eigenschaft CachePolicy Ruft 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 Eigenschaft CanRaiseEvents Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Von Component geerbt.)
Öffentliche Eigenschaft Container Ruft den IContainer ab, der die Component enthält. (Von Component geerbt.)
Öffentliche Eigenschaft tt0f69eh.PortableClassLibrary(de-de,VS.100).gif Credentials Ruft die Netzwerkanmeldeinformationen ab, die an den Host gesendet und für die Authentifizierung der Anforderung verwendet werden, oder legt diese fest.
Geschützte Eigenschaft DesignMode Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Von Component geerbt.)
Öffentliche Eigenschaft tt0f69eh.PortableClassLibrary(de-de,VS.100).gif Encoding Ruft die Encoding zum Hoch- und Herunterladen von Zeichenfolgen ab oder legt diese fest.
Geschützte Eigenschaft Events Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Von Component geerbt.)
Öffentliche Eigenschaft tt0f69eh.PortableClassLibrary(de-de,VS.100).gif Headers Ruft eine Auflistung der Name-Wert-Paare für Header auf, die der Anforderung zugeordnet sind, oder legt diese fest.
Öffentliche Eigenschaft tt0f69eh.PortableClassLibrary(de-de,VS.100).gif IsBusy Ruft ab, ob gerade eine Webanforderung ausgeführt wird.
Öffentliche Eigenschaft Proxy Ruft den von diesem WebClient-Objekt verwendeten Proxy ab oder legt diesen fest.
Öffentliche Eigenschaft QueryString Ruft eine Auflistung der Name-Wert-Paare für Abfragen auf, die der Anforderung zugeordnet sind, oder legt diese fest.
Öffentliche Eigenschaft tt0f69eh.PortableClassLibrary(de-de,VS.100).gif ResponseHeaders Ruft eine Auflistung der Name-Wert-Paare für Header auf, die der Antwort zugeordnet sind.
Öffentliche Eigenschaft Site Ruft die ISite der Component ab oder legt diese fest. (Von Component geerbt.)
Öffentliche Eigenschaft tt0f69eh.PortableClassLibrary(de-de,VS.100).gif UseDefaultCredentials Ruft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif CancelAsync Bricht einen ausstehenden asynchronen Vorgang ab.
Öffentliche Methode CreateObjRef Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.)
Öffentliche Methode Dispose() Gibt sämtliche von der Component verwendeten Ressourcen frei. (Von Component geerbt.)
Geschützte Methode Dispose(Boolean) Gibt die vom Component verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von Component geerbt.)
Öffentliche Methode DownloadData(String) Lädt die Ressource mit dem angegebenen URI als Byte-Array herunter.
Öffentliche Methode DownloadData(Uri) Lädt die Ressource mit dem angegebenen URI als Byte-Array herunter.
Öffentliche Methode DownloadDataAsync(Uri) Lädt die angegebene Ressource als Byte-Array herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode DownloadDataAsync(Uri, Object) Lädt die angegebene Ressource als Byte-Array herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode DownloadFile(String, String) Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.
Öffentliche Methode DownloadFile(Uri, String) Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.
Öffentliche Methode DownloadFileAsync(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 Methode DownloadFileAsync(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 Methode DownloadString(String) Lädt die angeforderte Ressource als String herunter. Die herunterzuladende Ressource wird als String angegeben, der den URI enthält.
Öffentliche Methode DownloadString(Uri) Lädt die angeforderte Ressource als String herunter. Die herunterzuladende Ressource ist als Uri angegeben.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif DownloadStringAsync(Uri) Lädt die als Uri angegebene Ressource herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif DownloadStringAsync(Uri, Object) Lädt die angegebene Zeichenfolge in die angegebene Ressource herunter. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor die Component durch die Garbage Collection wieder zugänglich gemacht wird. (Von Component geerbt.)
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetLifetimeService Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.)
Geschützte Methode GetService Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Von Component geerbt.)
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif GetWebRequest Gibt ein WebRequest-Objekt für die angegebene Ressource zurück.
Geschützte Methode GetWebResponse(WebRequest) Gibt die WebResponse für die angegebene WebRequest zurück.
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif GetWebResponse(WebRequest, IAsyncResult) Gibt die WebResponse für die angegebene WebRequest mit dem angegebenen IAsyncResult zurück.
Öffentliche Methode InitializeLifetimeService Ruft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.)
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif MemberwiseClone() Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode MemberwiseClone(Boolean) Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.)
Geschützte Methode OnDownloadDataCompleted Löst das DownloadDataCompleted-Ereignis aus.
Geschützte Methode OnDownloadFileCompleted Löst das DownloadFileCompleted-Ereignis aus.
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OnDownloadProgressChanged Löst das DownloadProgressChanged-Ereignis aus.
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OnDownloadStringCompleted Löst das DownloadStringCompleted-Ereignis aus.
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OnOpenReadCompleted Löst das OpenReadCompleted-Ereignis aus.
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OnOpenWriteCompleted Löst das OpenWriteCompleted-Ereignis aus.
Geschützte Methode OnUploadDataCompleted Löst das UploadDataCompleted-Ereignis aus.
Geschützte Methode OnUploadFileCompleted Löst das UploadFileCompleted-Ereignis aus.
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OnUploadProgressChanged Löst das UploadProgressChanged-Ereignis aus.
Geschützte Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OnUploadStringCompleted Löst das UploadStringCompleted-Ereignis aus.
Geschützte Methode OnUploadValuesCompleted Löst das UploadValuesCompleted-Ereignis aus.
Öffentliche Methode OpenRead(String) Öffnet einen lesbaren Stream für die von einer Ressource mit dem als String angegebenen URI heruntergeladenen Daten.
Öffentliche Methode OpenRead(Uri) Öffnet einen lesbaren Stream für die von einer Ressource mit dem als Uri angegebenen URI heruntergeladenen Daten.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OpenReadAsync(Uri) Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OpenReadAsync(Uri, Object) Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode OpenWrite(String) Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.
Öffentliche Methode OpenWrite(Uri) Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben.
Öffentliche Methode OpenWrite(String, String) Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.
Öffentliche Methode OpenWrite(Uri, String) Öffnet mithilfe der angegebenen Methode einen Stream zum Schreiben von Daten in die angegebene Ressource.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OpenWriteAsync(Uri) Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OpenWriteAsync(Uri, String) Öffnet einen Stream, um Daten in die angegebene Ressource zu schreiben. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OpenWriteAsync(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 Methode ToString Gibt einen String zurück, der den Namen dieser Component enthält, sofern vorhanden. Diese Methode sollte nicht überschrieben werden. (Von Component geerbt.)
Öffentliche Methode UploadData(String, Byte[]) Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.
Öffentliche Methode UploadData(Uri, Byte[]) Lädt einen Datenpuffer in eine Ressource hoch, die von einem URI identifiziert wird.
Öffentliche Methode UploadData(String, String, Byte[]) Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.
Öffentliche Methode UploadData(Uri, String, Byte[]) Lädt einen Datenpuffer in die angegebene Ressource mit der angegebenen Methode hoch.
Öffentliche Methode UploadDataAsync(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 Methode UploadDataAsync(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 Methode UploadDataAsync(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 Methode UploadFile(String, String) Lädt die angegebene lokale Datei in eine Ressource mit dem angegebenen URI hoch.
Öffentliche Methode UploadFile(Uri, String) Lädt die angegebene lokale Datei in eine Ressource mit dem angegebenen URI hoch.
Öffentliche Methode UploadFile(String, String, String) Lädt die angegebene lokale Datei mithilfe der angegebenen Methode in die angegebene Ressource hoch.
Öffentliche Methode UploadFile(Uri, String, String) Lädt die angegebene lokale Datei mithilfe der angegebenen Methode in die angegebene Ressource hoch.
Öffentliche Methode UploadFileAsync(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 Methode UploadFileAsync(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 Methode UploadFileAsync(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 Methode UploadString(String, String) Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der POST-Methode hoch.
Öffentliche Methode UploadString(Uri, String) Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der POST-Methode hoch.
Öffentliche Methode UploadString(String, String, String) Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der angegebenen Methode hoch.
Öffentliche Methode UploadString(Uri, String, String) Lädt die angegebene Zeichenfolge in die angegebene Ressource mithilfe der angegebenen Methode hoch.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif UploadStringAsync(Uri, String) Lädt die angegebene Zeichenfolge in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif UploadStringAsync(Uri, String, String) Lädt die angegebene Zeichenfolge in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode tt0f69eh.PortableClassLibrary(de-de,VS.100).gif UploadStringAsync(Uri, String, String, Object) Lädt die angegebene Zeichenfolge in die angegebene Ressource hoch. Durch diese Methode wird der aufrufende Thread nicht blockiert.
Öffentliche Methode UploadValues(String, NameValueCollection) Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche Methode UploadValues(Uri, NameValueCollection) Lädt die angegebene Name-Wert-Auflistung in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche Methode UploadValues(String, String, NameValueCollection) Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche Methode UploadValues(Uri, String, NameValueCollection) Lädt die angegebene Name-Wert-Auflistung mit der angegebenen Methode in die durch den angegebenen URI identifizierte Ressource hoch.
Öffentliche Methode UploadValuesAsync(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 Methode UploadValuesAsync(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 Methode UploadValuesAsync(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.
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis Disposed Tritt ein, wenn die Komponente durch einen Aufruf der Dispose-Methode freigegeben wird. (Von Component geerbt.)
Öffentliches Ereignis DownloadDataCompleted Tritt ein, wenn ein asynchroner Datendownload abgeschlossen wird.
Öffentliches Ereignis DownloadFileCompleted Tritt ein, wenn ein asynchroner Dateidownload abgeschlossen wird.
Öffentliches Ereignis tt0f69eh.PortableClassLibrary(de-de,VS.100).gif DownloadProgressChanged Tritt ein, wenn Daten teilweise oder vollständig erfolgreich über einen asynchronen Download übertragen werden.
Öffentliches Ereignis tt0f69eh.PortableClassLibrary(de-de,VS.100).gif DownloadStringCompleted Tritt ein, wenn ein asynchroner Ressourcendownload abgeschlossen wird.
Öffentliches Ereignis tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OpenReadCompleted Tritt ein, wenn ein asynchroner Vorgang zum Öffnen eines Streams, der eine Ressource enthält, abgeschlossen wird.
Öffentliches Ereignis tt0f69eh.PortableClassLibrary(de-de,VS.100).gif OpenWriteCompleted Tritt ein, wenn ein asynchroner Vorgang zum Öffnen eines Streams, der Daten in eine Ressource schreibt, abgeschlossen wird.
Öffentliches Ereignis UploadDataCompleted Tritt ein, wenn ein asynchroner Datenupload abgeschlossen wird.
Öffentliches Ereignis UploadFileCompleted Tritt ein, wenn ein asynchroner Dateiupload abgeschlossen wird.
Öffentliches Ereignis tt0f69eh.PortableClassLibrary(de-de,VS.100).gif UploadProgressChanged Tritt ein, wenn Daten teilweise oder vollständig erfolgreich über einen asynchronen Upload übertragen werden.
Öffentliches Ereignis tt0f69eh.PortableClassLibrary(de-de,VS.100).gif UploadStringCompleted Tritt ein, wenn ein asynchroner Zeichenfolgenupload abgeschlossen wird.
Öffentliches Ereignis UploadValuesCompleted Tritt ein, wenn ein asynchroner Upload einer Name-Wert-Auflistung 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.

Hinweis Hinweis

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

Beschreibungen

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

Beschreibungen

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.

C#
C++
VB
Kopieren 

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, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Unterstützt in:
  • WebPermission  

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

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. 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.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ