Читать «C# 4.0: полное руководство» онлайн - страница 652

Герберт Шилдт

Таблица 26.1. Методы, определенные в классе WebRequest

Метод - Описание

public static WebRequest Create(string requestUriString) - Создает объект типа WebRequest для идентификатора URI, указываемого в строке requestUriString. Возвращаемый объект реализует протокол, заданный префиксом идентификатора URI. Следовательно, возвращаемый объект будет экземпляром класса, призводного от класса WebRequest. Если затребованный протокол недоступен, то генерируется исключение NotSupportedException. А если недействителен указанный формат идентификатора URI, то генерируется исключение UriFormatException

public static WebRequest Create(Uri requestUri) - Создает объект типа WebRequest для идентификатора URI, указываемого с помощью параметра reques tUri. Возвращаемый объект реализует протокол, заданный префиксом идентификатора URI. Следовательно, возвращаемый объект будет экземпляром класса, призводного от класса WebRequest. Если затребованный протокол недоступен, то генерируется исключение NotSupportedException

public virtual Stream GetRequestStream() - Возвращает поток вывода, связанный с запрошенным ранее идентификатором URI

public virtual WebResponse GetResponse() -  Отправляет предварительно сформированный запрос и джидает ответа. Получив ответ, возвращает его в виде объекта класса WebReponse. Этот объект используется затем в программе для получения информации по указанному адресу URI

Таблица 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; } - Если принимает логическое значение true, то в отправляемый запрос включается информация для аутентификации. А если принимает логическое значение false, то информация для аутентификации предоставляется только по требованию адресата URI