Прочитать на английском

Поделиться через


HttpListenerContext Класс

Определение

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

public sealed class HttpListenerContext
Наследование
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;
}

Комментарии

Этот класс предоставляет сведения, связанные с запросом клиента 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)

Применяется к

Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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