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 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
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
Devoluciones
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de