WebClient.DownloadString Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

Загружает запрошенный Stringресурс в виде . Ресурс для скачивания может быть указан как String содержащий универсальный код ресурса (URI) или a Uri.

Перегрузки

Имя	Описание
DownloadString(String)	Загружает запрошенный Stringресурс в виде . Ресурс для скачивания указывается как содержащий универсальный String код ресурса (URI).
DownloadString(Uri)	Загружает запрошенный Stringресурс в виде . Ресурс, который нужно скачать, указывается в виде Uri.

DownloadString(String)

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

WebClient.cs

Загружает запрошенный Stringресурс в виде . Ресурс для скачивания указывается как содержащий универсальный String код ресурса (URI).

public:
 System::String ^ DownloadString(System::String ^ address);

public string DownloadString(string address);

member this.DownloadString : string -> string

Public Function DownloadString (address As String) As String

Параметры

address

String

Содержащий String URI для скачивания.

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

String

Объект String , содержащий запрошенный ресурс.

Исключения

ArgumentNullException

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

WebException

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

-или-

Произошла ошибка при скачивании ресурса.

NotSupportedException

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

Примеры

В следующем примере кода показано, как вызвать этот метод.

void DownloadString( String^ address )
{
   WebClient^ client = gcnew WebClient;
   String^ reply = client->DownloadString( address );
   Console::WriteLine( reply );
}

public static void DownloadString(string address)
{
    WebClient client = new WebClient();
    string reply = client.DownloadString(address);

    Console.WriteLine(reply);
}

Public Shared Sub DownloadString(ByVal address As String)

    Dim client As WebClient = New WebClient()
    Dim reply As String = client.DownloadString(address)

    Console.WriteLine(reply)
End Sub

Комментарии

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

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

Этот метод извлекает указанный ресурс. После скачивания ресурса метод использует кодировку, указанную в свойствеEncoding, для преобразования ресурса в .String Этот метод блокирует скачивание ресурса. Чтобы скачать ресурс и продолжить выполнение во время ожидания ответа сервера, используйте один из DownloadStringAsync методов.

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

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

Заметка

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

DownloadString(Uri)

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

WebClient.cs

Загружает запрошенный Stringресурс в виде . Ресурс, который нужно скачать, указывается в виде Uri.

public:
 System::String ^ DownloadString(Uri ^ address);

public string DownloadString(Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String

Параметры

address

Uri

Uri Объект, содержащий URI для скачивания.

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

String

Объект String , содержащий запрошенный ресурс.

Исключения

ArgumentNullException

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

WebException

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

-или-

Произошла ошибка при скачивании ресурса.

NotSupportedException

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

Комментарии

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

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

Этот метод извлекает указанный ресурс. После скачивания ресурса метод использует кодировку, указанную в свойствеEncoding, для преобразования ресурса в .String Этот метод блокирует скачивание ресурса. Чтобы скачать ресурс и продолжить выполнение во время ожидания ответа сервера, используйте один из DownloadStringAsync методов.

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

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

Заметка

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