HttpListenerContext Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к объектам запросов и ответов, используемых классом HttpListener. Этот класс не наследуется.
public ref class HttpListenerContext sealed
public sealed class HttpListenerContext
type HttpListenerContext = class
Public NotInheritable 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;
}
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) |