WebClient.DownloadData Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- WebClient.cs
- 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
Matriz Byte que contiene el recurso descargado.
Excepciones
El parámetro address es null.
El URI formado mediante la combinación de BaseAddress y address no es válido.
-o-
Error al descargar datos.
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.
Se aplica a
DownloadData(Uri)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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
Matriz Byte que contiene el recurso descargado.
Excepciones
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.
