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

Параметр 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

Комментарии

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

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

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

Комментарии

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

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

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

Примечание

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