WebClient.DownloadData Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Descarga el recurso como una matriz de Byte del URI especificado.

Sobrecargas

DownloadData(String)	Descarga el recurso como una matriz de Byte del URI especificado.
DownloadData(Uri)	Descarga el recurso como una matriz de Byte del URI especificado.

DownloadData(String)

Source:

WebClient.cs

Descarga el recurso como una matriz de Byte del URI especificado.

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()

Parámetros

address

String

Identificador URI desde el que se van a descargar los datos.

Devoluciones

Byte[]

Matriz Byte que contiene el recurso descargado.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

El URI formado mediante la combinación de BaseAddress y address no es válido.

-o-

Error al descargar datos.

NotSupportedException

Se ha llamado al método simultáneamente en varios subprocesos.

Ejemplos

En el ejemplo de código siguiente se solicitan datos de un servidor y se muestran los datos devueltos. Se supone que remoteUri contiene un URI válido para los datos solicitados.

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.")

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

El método DownloadData descarga el recurso con el URI especificado por el parámetro address. Este método se bloquea al descargar el recurso. Para descargar un recurso y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos DownloadDataAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.

DownloadData(Uri)

Source:

WebClient.cs

Descarga el recurso como una matriz de Byte del URI especificado.

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()

Parámetros

address

Uri

Identificador URI representado por el objeto Uri, desde el que se van a descargar los datos.

Devoluciones

Byte[]

Matriz Byte que contiene el recurso descargado.

Excepciones

ArgumentNullException

El parámetro address es null.

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

El método DownloadData descarga el recurso con el URI especificado por el parámetro address. Este método se bloquea al descargar el recurso. Para descargar un recurso y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos DownloadDataAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.