WebClient.DownloadString Méthode
Définition
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.
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
- 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
String contenant la ressource demandée.
Exceptions
Le paramètre address
a la valeur null
.
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.
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.
S’applique à
DownloadString(Uri)
- 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
String contenant la ressource demandée.
Exceptions
Le paramètre address
a la valeur null
.
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.
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.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour