WebClient.DownloadString Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

Загружает запрошенный ресурс в виде String. Ресурс для скачивания может быть указан как String, содержащий URI или 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

Параметр addressnull.

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

Параметр addressnull.

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.