C# 4.0 полное руководство - 2011

Кроме того, в классеWebClientопределяются свойства, сведенные в табл. 26.6, а также целый ряд методов, поддерживающих как синхронную, так и асинхронную передачу данных. Но поскольку рассмотрение асинхронной передачи данных выходит за рамки этой главы, то в табл. 26.7 приведены только те методы, которые поддерживают синхронную передачу данных. Все методы классаWebClientгенерируют исключениеWebException,если во время передачи данных возникает ошибка.

Таблица 26.6. Свойства, определенные в классе WebClient

Свойство

Описание

public string BaseAddress { get; set; }

public RequestCachePolicy CachePolicy { get; set; } public ICredentials Credentials { get; set; }

public Encoding Encoding { get; set; }

Получает или устанавливает базовый адрес требуемого URI. Если это свойство установлено, то адреса, задаваемые в методах класса WebClient, должны определяться относительно этого базового адреса Получает или устанавливает правила, определяющие, когда именно используется кэш¹ Получает или устанавливает мандат, т.е. учетные данные пользователя. По умолчанию это свойство имеет пустое значение

Получает или устанавливает схему кодирования символов при передаче строк

Свойство

Описание

public WebHeaderCollection Headers! get; set; } public bool IsBusy( get; }

public IWebProxy Proxy { get; set; }

,public NameValueCollection QueryString { get; set; }

public WebHeaderCollection ResponseHeaders{ get; } public bool

UseDefaultCredentials { get; set; }

Получает или устанавливает коллекцию заголовков запроса

Принимает логическое значение true, если данные по-прежнему передаются по запросу, а иначе — логическое значение false Получает или устанавливает прокси-сервер

Получает или устанавливает строку запроса, состоящую из пар “имя-значение”, которые могут быть присоединены к запросу. Строка запроса отделяется от URI символом ?. Если же таких пар несколько, то каждая из них отделяется символом 0 Получает коллекцию заголовков ответа

Получает или устанавливает значение, которое определяет, используется ли для аутентификации устанавливаемый по умолчанию мандат. Если принимает логическое значение true, то используется мандат, устанавливаемый по умолчанию, т.е. учетные данные пользователя, в противном случае этот мандат не используется

Таблица 26.7. Методы синхронной передачи, определенные в классе WebClient

Метод

Определение

public byte[]

Загружает информацию по адресу UR1, обозначае

DownloadData(stringaddress)

мому параметром address. Возвращает результат в виде массива байтов

public byte[]

Загружает информацию по адресу URI, обозначае

DownloadData(Uriaddress)

мому параметром address. Возвращает результат в виде массива байтов

public void

Загружает информацию по адресу URI, обозначае

DownloadFile(stringuri,

мому параметром fileName. Сохраняет результат

stringfileName)

в файле fileName

public void DownloadFile(Uri

Загружает информацию по адресу URI, обозначае

address,stringfileName)

мому параметром address. Сохраняет результат в файле fileName

public string

Загружает информацию по адресу URI, обозначае

DownloadString(string

мому параметром address. Возвращает результат

address)

в виде символьной строки типа string

public string

Загружает информацию по адресу URI, обозначае

DownloadString(Uriaddress)

мому параметром address. Возвращает результат в виде символьной строки типа string

public Stream

Возвращает поток ввода для чтения информации по

OpenRead(stringaddress)

адресу URI, обозначаемому параметром address. По окончании чтения информации этот поток необходимо закрыть

Метод

Определение

public Stream OpenRead(Uri

Возвращает поток ввода для чтения информации по

address)

адресу URI, обозначаемому параметром address. По окончании чтения информации этот поток необходимо закрыть

public Stream

Возвращает поток вывода для записи информа