HttpListenerContext Класс

Определение

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

System.Net

Сборки:

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

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

• HttpListener
• HttpListenerRequest
• HttpListenerResponse