WebClient.DownloadData Метод

Определение

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

System.Net

Сборка:

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

Комментарии

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с 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.

Комментарии

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

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

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

Примечание

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