C# 4.0 полное руководство - 2011
Шрифт:
В классе WebClient определяется единственный конструктор.
public WebClient
Кроме того, в классе 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, должны определяться относительно этого базового адреса Получает или устанавливает правила, определяющие, когда именно используется кэш1 Получает или устанавливает мандат, т.е. учетные данные пользователя. По умолчанию это свойство имеет пустое значение
Получает или устанавливает схему кодирования символов при передаче строк
Свойство
Описание
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(string address)
мому параметром address. Возвращает результат в виде массива
public byte[]
Загружает информацию по адресу URI, обозначае
DownloadData(Uri address)
мому параметром address. Возвращает результат в виде массива байтов
public void
Загружает информацию по адресу URI, обозначае
DownloadFile(string uri,
мому параметром fileName. Сохраняет результат
string fileName)
в файле fileName
public void DownloadFile(Uri
Загружает информацию по адресу URI, обозначае
address, string fileName)
мому параметром address. Сохраняет результат в файле fileName
public string
Загружает информацию по адресу URI, обозначае
DownloadString(string
мому параметром address. Возвращает результат
address)
в виде символьной строки типа string
public string
Загружает информацию по адресу URI, обозначае
DownloadString(Uri address)
мому параметром address. Возвращает результат в виде символьной строки типа string
public Stream
Возвращает поток ввода для чтения информации по
OpenRead(string address)
адресу URI, обозначаемому параметром address. По окончании чтения информации этот поток необходимо закрыть
Метод
Определение
public Stream OpenRead(Uri
Возвращает поток ввода для чтения информации по
address)
адресу URI, обозначаемому параметром address. По окончании чтения информации этот поток необходимо закрыть