WebClient.DownloadData Método

Definición

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

Sobrecargas

DownloadData(String)

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

DownloadData(Uri)

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

DownloadData(String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Descarga el recurso como una matriz de Byte desde el 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

URI desde el que se descargan los datos.

Devoluciones

Byte[]

Matriz Byte que contiene el recurso descargado.

Excepciones

El parámetro address es null.

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

Se ha producido un error al descargar los datos.

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

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

El DownloadData método descarga el recurso con el URI especificado por el address parámetro . 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 DownloadDataAsync métodos .

Si la BaseAddress propiedad 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 QueryString propiedad 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 cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red 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 desde el 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 descargan los datos.

Devoluciones

Byte[]

Matriz Byte que contiene el recurso descargado.

Excepciones

El parámetro address es null.

Comentarios

El DownloadData método descarga el recurso con el URI especificado por el address parámetro . 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 DownloadDataAsync métodos .

Si la BaseAddress propiedad 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 QueryString propiedad 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 cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.

Se aplica a