WebClient.DownloadString Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

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

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:
 System::String ^ DownloadString(System::String ^ address);

public string DownloadString (string address);

member this.DownloadString : string -> string

Public Function DownloadString (address As String) As String

Paramètres

address

String

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

Retours

String

Une String contenant la ressource demandée.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

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.

NotSupportedException

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.

void DownloadString( String^ address )
{
   WebClient^ client = gcnew WebClient;
   String^ reply = client->DownloadString( address );
   Console::WriteLine( reply );
}

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

    Console.WriteLine(reply);
}

Public Shared Sub DownloadString(ByVal address As String)

    Dim client As WebClient = New WebClient()
    Dim reply As String = client.DownloadString(address)

    Console.WriteLine(reply)
End Sub

Remarques

Prudence

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.

Note

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.

DownloadString(Uri)

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:
 System::String ^ DownloadString(Uri ^ address);

public string DownloadString (Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String

Paramètres

address

Uri

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

Retours

String

Une String contenant la ressource demandée.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

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.

NotSupportedException

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

Remarques

Prudence

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.

Note

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.