HttpListenerContext Класс

Определение

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

System.Net

Сборка:

System.Net.HttpListener.dll

Сборка:

System.dll

Сборка:

netstandard.dll

Предоставляет доступ к объектам запросов и ответов, используемых классом 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