HttpListenerContext Класс

Определение

Пространство имен:

System.Net

Сборка:

System.Net.HttpListener.dll

Исходный код:

HttpListenerContext.cs

Предоставляет доступ к объектам запросов и ответов, используемых классом HttpListener. Этот класс не наследуется.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Наследование

Object

HttpListenerContext

Примеры

В следующем примере кода отображаются сведения о пользователе для клиентского запроса.

public static string ClientInformation(HttpListenerContext context)
{
    System.Security.Principal.IPrincipal user = context.User;
    System.Security.Principal.IIdentity id = user.Identity;
    if (id == null)
    {
        return "Client authentication is not enabled for this Web server.";
    }

    string display;
    if (id.IsAuthenticated)
    {
        display = String.Format("{0} was authenticated using {1}", id.Name,
            id.AuthenticationType);
    }
    else
    {
       display = String.Format("{0} was not authenticated", id.Name);
    }
    return display;
}

Public Shared Function ClientInformation(ByVal context As HttpListenerContext) As String
    Dim user As System.Security.Principal.IPrincipal = context.User
    Dim id As System.Security.Principal.IIdentity = user.Identity

    If id Is Nothing Then
        Return "Client authentication is not enabled for this Web server."
    End If

    Dim display As String

    If id.IsAuthenticated Then
        display = String.Format("{0} was authenticated using {1}", id.Name, id.AuthenticationType)
    Else
        display = String.Format("{0} was not authenticated", id.Name)
    End If

    Return display
End Function

Комментарии

Этот класс предоставляет сведения, связанные с http-запросом клиента, обрабатываемым HttpListener объектом . Этот класс также содержит методы, которые позволяют HttpListener объекту принимать подключение WebSocket.

Метод GetContext возвращает экземпляры HttpListenerContext класса . Чтобы получить объект , представляющий клиентский запрос, используйте Request свойство . Чтобы получить объект , представляющий ответ, который будет отправлен клиенту HttpListener, используйте Response свойство . Чтобы получить сведения о клиенте, отправляя запрос, например имя для входа и то, прошел ли он проверку подлинности, можно запросить свойства в объекте IPrincipal , возвращаемом свойством User .

HttpListenerContext Закрытие объекта отправляет ответ клиенту и освобождает все ресурсы, используемые HttpListenerContext. Прерывание HttpListenerContext объекта удаляет ответ клиенту, если он еще не был отправлен, и освобождает все ресурсы, используемые HttpListenerContext. После закрытия или прерывания HttpListenerContext объекта нельзя ссылаться на его методы или свойства. В этом случае вы получите ObjectDisposedException исключение.

Свойства

Request	Возвращает объект HttpListenerRequest, который представляет клиентский запрос ресурса.
Response	Возвращает объект HttpListenerResponse, который будет отправлен клиенту в ответ на клиентский запрос.
User	Возвращает объект, используемый для получения идентификации, сведений проверки подлинности и ролей безопасности для клиента, запрос которого представлен этим объектом HttpListenerContext.

Методы

AcceptWebSocketAsync(String)	Принять подключение WebSocket как асинхронную операцию.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Принять подключение WebSocket, задав поддерживаемый подпротокол WebSocket, размер буфера получения и интервал проверки активности WebSocket как асинхронную операцию.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Принять подключение WebSocket, задав поддерживаемый подпротокол WebSocket, размер буфера получения и интервал проверки активности WebSocket и внутренний буфер как асинхронную операцию.
AcceptWebSocketAsync(String, TimeSpan)	Примите подключение WebSocket, указав поддерживаемый под-протокол WebSocket и интервал активности WebSocket в качестве асинхронной операции.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• HttpListener
• HttpListenerRequest
• HttpListenerResponse