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 comme String contenant l'URI ou comme Uri.

Surcharges

DownloadString(String)	Télécharge la ressource demandée en tant que String. La ressource à télécharger est spécifiée comme String contenant l'URI.
DownloadString(Uri)	Télécharge la ressource demandée en tant que String. La ressource à télécharge est spécifiée comme 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 comme 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

String contenant l'URI à télécharger.

Retours

String

String contenant la ressource demandée.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

WebException

L'URI formé en combinant la propriété 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 sur plusieurs threads simultanément.

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

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 Encoding propriété pour convertir la ressource en .String Cette méthode se bloque lors du téléchargement de la ressource. Pour télécharger une ressource et poursuivre l’exécution en attendant la réponse du serveur, utilisez l’une DownloadStringAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété 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 traçage lorsque vous activez le traçage 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écharge est spécifiée comme 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

String contenant la ressource demandée.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

WebException

L'URI formé en combinant la propriété 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 sur plusieurs threads simultanément.

Remarques

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 Encoding propriété pour convertir la ressource en .String Cette méthode se bloque lors du téléchargement de la ressource. Pour télécharger une ressource et poursuivre l’exécution en attendant la réponse du serveur, utilisez l’une DownloadStringAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété 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 traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.