Lire en anglais

Partager via


WebClient.DownloadString Méthode

Définition

Télécharge la ressource demandée en tant que String. La ressource à télécharger peut être spécifiée en tant que String contenant l’URI ou un Uri.

Surcharges

DownloadString(String)

Télécharge la ressource demandée en tant que String. La ressource à télécharger est spécifiée en tant que String contenant l’URI.

DownloadString(Uri)

Télécharge la ressource demandée en tant que String. La ressource à télécharger est spécifiée en tant que Uri.

DownloadString(String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Télécharge la ressource demandée en tant que String. La ressource à télécharger est spécifiée en tant que String contenant l’URI.

public string DownloadString (string address);

Paramètres

address
String

Une String contenant l’URI à télécharger.

Retours

Une String contenant la ressource demandée.

Exceptions

Le paramètre address est null.

L’URI formé en combinant BaseAddress et address n’est pas valide.

-ou-

Une erreur s’est produite lors du téléchargement de la ressource.

La méthode a été appelée simultanément sur plusieurs threads.

Exemples

L’exemple de code suivant illustre l’appel de cette méthode.

public static void DownloadString(string address)
{
    WebClient client = new WebClient();
    string reply = client.DownloadString(address);

    Console.WriteLine(reply);
}

Remarques

Attention

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Cette méthode récupère la ressource spécifiée. Une fois la ressource téléchargée, la méthode utilise l’encodage spécifié dans la propriété Encoding pour convertir la ressource en String. Cette méthode bloque lors du téléchargement de la ressource. Pour télécharger une ressource et continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes DownloadStringAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.

Cette méthode utilise la commande RETR pour télécharger une ressource FTP. Pour une ressource HTTP, la méthode GET est utilisée.

Notes

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

DownloadString(Uri)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Télécharge la ressource demandée en tant que String. La ressource à télécharger est spécifiée en tant que Uri.

public string DownloadString (Uri address);

Paramètres

address
Uri

Objet Uri contenant l’URI à télécharger.

Retours

Une String contenant la ressource demandée.

Exceptions

Le paramètre address est null.

L’URI formé en combinant BaseAddress et address n’est pas valide.

-ou-

Une erreur s’est produite lors du téléchargement de la ressource.

La méthode a été appelée simultanément sur plusieurs threads.

Remarques

Attention

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Cette méthode récupère la ressource spécifiée. Une fois la ressource téléchargée, la méthode utilise l’encodage spécifié dans la propriété Encoding pour convertir la ressource en String. Cette méthode bloque lors du téléchargement de la ressource. Pour télécharger une ressource et continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes DownloadStringAsync.

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.

Cette méthode utilise la commande RETR pour télécharger une ressource FTP. Pour une ressource HTTP, la méthode GET est utilisée.

Notes

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1