WebClient.DownloadData Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

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

Перегрузки

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

DownloadData(String)

Исходный код:

WebClient.cs

Загружает ресурс в виде массива 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.")

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

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

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

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

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

DownloadData(Uri)

Исходный код:

WebClient.cs

Загружает ресурс в виде массива 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.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

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

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

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

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.