WebClient.DownloadString Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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. |
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
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
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.
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
Attention
WebRequest
, HttpWebRequest
, ServicePoint
et 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 |
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
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
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
, ServicePoint
et 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 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :