WebClient.DownloadData Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Télécharge la ressource en tant que tableau Byte à partir de l'URI spécifié.

Surcharges

DownloadData(String)	Télécharge la ressource en tant que tableau Byte à partir de l'URI spécifié.
DownloadData(Uri)	Télécharge la ressource en tant que tableau Byte à partir de l'URI spécifié.

DownloadData(String)

Source:

WebClient.cs

Télécharge la ressource en tant que tableau Byte à partir de l'URI spécifié.

public:
 cli::array <System::Byte> ^ DownloadData(System::String ^ address);

public byte[] DownloadData (string address);

member this.DownloadData : string -> byte[]

Public Function DownloadData (address As String) As Byte()

Paramètres

address

String

URI à partir duquel télécharger des données.

Retours

Byte[]

Tableau de Byte contenant la ressource téléchargé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 données.

NotSupportedException

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

Exemples

L’exemple de code suivant demande des données à partir d’un serveur et affiche les données retournées. Il suppose que remoteUri contient un URI valide pour les données demandées.

Console::Write( "\nPlease enter a URI (e.g. http://www.contoso.com): " );
String^ remoteUri = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Download home page data.
Console::WriteLine( "Downloading {0}", remoteUri );
// Download the Web resource and save it into a data buffer.
array<Byte>^ myDataBuffer = myWebClient->DownloadData( remoteUri );

// Display the downloaded data.
String^ download = Encoding::ASCII->GetString( myDataBuffer );
Console::WriteLine( download );

Console::WriteLine( "Download successful." );

Console.Write("\nPlease enter a URI (for example, http://www.contoso.com): ");
string remoteUri = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Download home page data.
Console.WriteLine("Downloading " + remoteUri);                        
// Download the Web resource and save it into a data buffer.
byte[] myDataBuffer = myWebClient.DownloadData (remoteUri);

// Display the downloaded data.
string download = Encoding.ASCII.GetString(myDataBuffer);
Console.WriteLine(download);
                    
Console.WriteLine("Download successful.");

Console.Write(ControlChars.Cr + "Please enter a Url(for example, http://www.msn.com): ")
Dim remoteUrl As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Download the home page data.
Console.WriteLine(("Downloading " + remoteUrl))
' DownloadData() method takes a 'uriRemote.ToString()' and downloads the Web resource and saves it into a data buffer.
Dim myDatabuffer As Byte() = myWebClient.DownloadData(remoteUrl)

' Display the downloaded data.
Dim download As String = Encoding.ASCII.GetString(myDataBuffer)
Console.WriteLine(download)

Console.WriteLine("Download successful.")

Remarques

La DownloadData méthode télécharge la ressource avec l’URI spécifié par le address paramètre . 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 DownloadDataAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address ne contient pas d’URI absolu, address il doit s’agir d’un URI relatif 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.

DownloadData(Uri)

Source:

WebClient.cs

Télécharge la ressource en tant que tableau Byte à partir de l'URI spécifié.

public:
 cli::array <System::Byte> ^ DownloadData(Uri ^ address);

public byte[] DownloadData (Uri address);

member this.DownloadData : Uri -> byte[]

Public Function DownloadData (address As Uri) As Byte()

Paramètres

address

Uri

URI représenté par l'objet Uri, à partir duquel télécharger des données.

Retours

Byte[]

Tableau de Byte contenant la ressource téléchargée.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

Remarques

La DownloadData méthode télécharge la ressource avec l’URI spécifié par le address paramètre . 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 DownloadDataAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address ne contient pas d’URI absolu, address il doit s’agir d’un URI relatif 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.