WebClient.DownloadString WebClient.DownloadString WebClient.DownloadString WebClient.DownloadString Method

Определение

Загружает требуемый ресурс как строку String.Downloads the requested resource as a String. Ресурс, который требуется загрузить, может быть указан как строка String, содержащая URI, или как Uri.The resource to download may be specified as either String containing the URI or a Uri.

Перегрузки

DownloadString(String) DownloadString(String) DownloadString(String) DownloadString(String)

Загружает требуемый ресурс как строку String.Downloads the requested resource as a String. Ресурс, который требуется загрузить, указан как строка String, содержащая URI.The resource to download is specified as a String containing the URI.

DownloadString(Uri) DownloadString(Uri) DownloadString(Uri) DownloadString(Uri)

Загружает требуемый ресурс как строку String.Downloads the requested resource as a String. Загружаемый ресурс указан как Uri.The resource to download is specified as a Uri.

DownloadString(String) DownloadString(String) DownloadString(String) DownloadString(String)

Загружает требуемый ресурс как строку String.Downloads the requested resource as a String. Ресурс, который требуется загрузить, указан как строка String, содержащая URI.The resource to download is specified as a String containing the 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 String String

String, в котором содержится URI загрузки.A String containing the URI to download.

Возвраты

Строка String, содержащая требуемый ресурс.A String containing the requested resource.

Исключения

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

URI, образованный объединением BaseAddress и address, является недопустимым.The URI formed by combining BaseAddress and address is invalid.

-или--or- Произошла ошибка при загрузке ресурса.An error occurred while downloading the resource.

Этот метод был вызван одновременно из нескольких потоков.The method has been called simultaneously on multiple threads.

Примеры

В следующем примере кода демонстрируется вызов этого метода.The following code example demonstrates calling this method.

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


Комментарии

Этот метод получает указанный ресурс.This method retrieves the specified resource. После загрузки ресурса, данный метод использует кодировку, заданную в Encoding свойство позволит преобразовать желаемый ресурс для String.After it downloads the resource, the method uses the encoding specified in the Encoding property to convert the resource to a String. Этот метод блокируется при загрузке ресурса.This method blocks while downloading the resource. Чтобы загрузить ресурс и продолжить выполнение при ожидании ответа сервера, используйте один из DownloadStringAsync методы.To download a resource and continue executing while waiting for the server's response, use one of the DownloadStringAsync methods.

Если BaseAddress свойство не является пустой строкой ("») и address не содержит абсолютный URI, address должен быть относительным URI, который используется в сочетании с BaseAddress для формирования абсолютного URI запрошенные данные.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Если QueryString свойство не является пустой строкой, оно добавляется к address.If the QueryString property is not an empty string, it is appended to address.

Этот метод использует команду RETR для загрузки FTP-ресурса.This method uses the RETR command to download an FTP resource. Для HTTP-ресурса используется метод GET.For an HTTP resource, the GET method is used.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети.This member outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе сетевая трассировка в .NET Framework.For more information, see Network Tracing in the .NET Framework.

DownloadString(Uri) DownloadString(Uri) DownloadString(Uri) DownloadString(Uri)

Загружает требуемый ресурс как строку String.Downloads the requested resource as a String. Загружаемый ресурс указан как Uri.The resource to download is specified as a 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 Uri

Объект Uri, содержащий URI загрузки.A Uri object containing the URI to download.

Возвраты

Строка String, содержащая требуемый ресурс.A String containing the requested resource.

Исключения

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

URI, образованный объединением BaseAddress и address, является недопустимым.The URI formed by combining BaseAddress and address is invalid.

-или--or- Произошла ошибка при загрузке ресурса.An error occurred while downloading the resource.

Этот метод был вызван одновременно из нескольких потоков.The method has been called simultaneously on multiple threads.

Комментарии

Этот метод получает указанный ресурс.This method retrieves the specified resource. После загрузки ресурса, данный метод использует кодировку, заданную в Encoding свойство позволит преобразовать желаемый ресурс для String.After it downloads the resource, the method uses the encoding specified in the Encoding property to convert the resource to a String. Этот метод блокируется при загрузке ресурса.This method blocks while downloading the resource. Чтобы загрузить ресурс и продолжить выполнение при ожидании ответа сервера, используйте один из DownloadStringAsync методы.To download a resource and continue executing while waiting for the server's response, use one of the DownloadStringAsync methods.

Если BaseAddress свойство не является пустой строкой ("») и address не содержит абсолютный URI, address должен быть относительным URI, который используется в сочетании с BaseAddress для формирования абсолютного URI запрошенные данные.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Если QueryString свойство не является пустой строкой, оно добавляется к address.If the QueryString property is not an empty string, it is appended to address.

Этот метод использует команду RETR для загрузки FTP-ресурса.This method uses the RETR command to download an FTP resource. Для HTTP-ресурса используется метод GET.For an HTTP resource, the GET method is used.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети.This member outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе сетевая трассировка в .NET Framework.For more information, see Network Tracing in the .NET Framework.

Применяется к