WebClient.DownloadData Метод

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.WebClient.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Загружает ресурс, как массив Byte из заданного URI.

Перегрузки

DownloadData(String)

Загружает ресурс, как массив Byte из заданного URI.
DownloadData(Uri)

Загружает ресурс, как массив Byte из заданного URI.

DownloadData(String)

Загружает ресурс, как массив Byte из заданного URI.

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

Параметры

address
String

URI, с которого будут загружены данные.

Возвращаемое значение

Byte[]

Массив Byte, содержащий загруженный ресурс.

Исключения

ArgumentNullException

Параметр address имеет значение null.

WebException

URI, образованный объединением BaseAddress и address, является недопустимым.

-или-

При загрузке данных произошла ошибка.

NotSupportedException

Этот метод был вызван одновременно из нескольких потоков.

Примеры

В следующем примере кода запрашиваются данные с сервера и отображаются возвращенные данные. Предполагается, что remoteUri содержит допустимый универсальный код ресурса (URI) для запрошенных данных.

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

Комментарии

Метод DownloadData скачивает ресурс с URI, заданным параметром address . Этот метод блокирует загрузку ресурса. Чтобы скачать ресурс и продолжить выполнение во время ожидания ответа сервера, используйте один из DownloadDataAsync методов.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address объединенным с BaseAddress тем, чтобы сформировать абсолютный универсальный код ресурса (URI) запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе "Трассировка сети" в платформа .NET Framework.

Применяется к

DownloadData(Uri)

Загружает ресурс, как массив Byte из заданного URI.

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

Параметры

address
Uri

Универсальный код ресурса (URI), представленный объектом Uri, из которого следует загрузить данные.

Возвращаемое значение

Byte[]

Массив Byte, содержащий загруженный ресурс.

Исключения

ArgumentNullException

Параметр address имеет значение null.

Комментарии

Метод DownloadData скачивает ресурс с URI, заданным параметром address . Этот метод блокирует скачивание ресурса. Чтобы скачать ресурс и продолжить выполнение во время ожидания ответа сервера, используйте один из DownloadDataAsync методов.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), то должен быть относительным универсальным кодом ресурса (URI), address который объединяется с BaseAddress абсолютным универсальным кодом ресурса (URI) запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется в address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе "Трассировка сети" в платформа .NET Framework.

Применяется к