Таблица 26.2. Свойства, определенные в классе WebRequest
Свойство
Описание
public AuthenticationLevel
Получает или устанавливает уровень аутентифи
AuthenticationLevel( get; set; }
кации
public virtual
Получает или устанавливает правила использо
RequestCachePolicy CachePolicy
вания кеша, определяющие момент получения
{ get; set; }
ответа из кеша
public virtual string
Получает или устанавливает имя группы подклю
ConnectionGroupName { get;
чения. Группы подключения представляют собой
set; }
способ создания ряда запросов. Они не нужны для простых транзакций в Интернете
public virtual long
Получает или устанавливает длину передаваемо
ContentLength { get; set; }
го содержимого
public virtual string
Получает или устанавливает описание переда
ContentType { get; set; }
ваемого содержимого
public virtual Icredentials
Получает или устанавливает мандат, т.е. учетные
Credentials { get; set; }
данные пользователя
public static
Получает или устанавливает правила использо
RequestCachePolicy
вания кеша по умолчанию, определяющие мо
DefaultCachePolicy { get; set; }
мент получения ответа из кеша
public static IWebProxy
Получает или устанавливает используемый по
DefaultWebProxy { get; set; }
умолчанию прокси-сервер
public virtual
Получает или устанавливает коллекцию заголовков
WebHeaderCollection Headers{
get; set; }
public TokenlmpersonationLevel
Получает или устанавливает уровень анонимно
ImpersonationLevel { get; set; }
го воплощения
Свойство
Описание
public virtual string Method { get; set; } public virtual bool PreAuthenticate { get; set; }
public virtual IWebProxy Proxy { get; set; }
public virtual Uri RequestUri { get; }
public virtual int Timeout { get; set; }
public virtual bool UseDefaultCredential { get; set; }
Получает или устанавливает протокол
Если принимает логическое значение true, то в отправляемый запрос включается информация для аутентификации. А если принимает логическое значение false, то информация для аутентификации предоставляется только по требованию адресата URI
Получает или устанавливает прокси-сервер. Применимо только в тех средах, где используется прокси-сервер
Получает идентификатор URI конкретного запроса
Получает или устанавливает количество миллисекунд, в течение которых будет ожидаться ответ на запрос. Для установки бесконечного ожидания используется значение Timeout. Infinite Получает или устанавливает значение, которое определяет, используется ли для аутентификации устанавливаемый по умолчанию мандат. Если имеет логическое значение true, то используется устанавливаемый по умолчанию мандат, т.е. учетные данные пользователя, в противном случае этот мандат не используется
Класс WebResponse
В классе WebResponse инкапсулируется ответ, получаемый по запросу. Этот класс является абстрактным. В наследующих от него классах создаются отдельные его версии, поддерживающие конкретный протокол. Объект класса WebResponse обычно получается в результате вызова метода GetResponse (), определенного в классе WebRequest. Этот объект будет экземпляром отдельного класса, производного от класса WebResponse и реализующего конкретный протокол. Методы, определенные в классе WebResponse, сведены в табл. 26.3, а свойства, объявляемые в этом классе, — в табл. 26.4. Значения этих свойств устанавливаются на основании каждого запроса в отдельности. Открытые конструкторы в классе WebResponse не определяются.
Таблица 26.3. Наиболее часто используемые методы, определенные в классе WebResponse
Метод
Описание
public virtual void Close() *
public virtual Stream GetResponseStream()
Закрывает ответный поток. Закрывает также поток ввода ответа, возвращаемый методом
GetResponseStream()
Возвращает поток ввода, связанный с запрашиваемым URI. Из этого потока могут быть введены данные из запрашиваемого URI
Свойство
Описание