WebClient.DownloadString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
DownloadString(String) |
Загружает требуемый ресурс как строку String. Ресурс, который требуется загрузить, указан как строка String, содержащая URI. |
DownloadString(Uri) |
Загружает требуемый ресурс как строку String. Загружаемый ресурс указан как Uri. |
DownloadString(String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
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
Параметры
Возвращаемое значение
Строка String, содержащая требуемый ресурс.
Исключения
Параметр address
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Произошла ошибка при загрузке ресурса.
Этот метод был вызван одновременно из нескольких потоков.
Примеры
В следующем примере кода демонстрируется вызов этого метода.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
public:
System::String ^ DownloadString(Uri ^ address);
public string DownloadString (Uri address);
member this.DownloadString : Uri -> string
Public Function DownloadString (address As Uri) As String
Параметры
Возвращаемое значение
Строка String, содержащая требуемый ресурс.
Исключения
Параметр address
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Произошла ошибка при загрузке ресурса.
Этот метод был вызван одновременно из нескольких потоков.
Комментарии
Этот метод извлекает указанный ресурс. После скачивания ресурса метод использует кодировку, указанную в свойстве Encoding , для преобразования ресурса Stringв . Этот метод блокируется при скачивании ресурса. Чтобы скачать ресурс и продолжить выполнение в ожидании ответа сервера, используйте один из DownloadStringAsync методов .
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, то это должен быть относительный URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных.
QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по