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

설명

이 클래스는 개체에서 처리 HttpListener 중인 클라이언트의 HTTP(Hypertext Transfer Protocol) 요청과 관련된 정보를 제공합니다. 이 클래스에는 개체가 WebSocket 연결을 수락할 수 있는 HttpListener 메서드도 있습니다.

메서드는 GetContext 클래스의 인스턴스를 HttpListenerContext 반환합니다. 클라이언트 요청을 나타내는 개체를 얻으려면 속성을 사용합니다 Request . 에 의해 HttpListener클라이언트로 전송될 응답을 나타내는 개체를 얻으려면 속성을 사용합니다 Response . 로그인 이름 및 인증 여부와 같이 요청을 보내는 클라이언트에 대한 사용자 정보를 얻으려면 속성에서 반환 User 된 개체의 IPrincipal 속성을 쿼리할 수 있습니다.

개체를 닫으면 HttpListenerContext 클라이언트에 응답을 보내고 에서 사용하는 모든 리소스를 HttpListenerContext해제합니다. 개체를 HttpListenerContext 중단하면 아직 전송되지 않은 경우 클라이언트에 대한 응답이 삭제되고 에서 사용하는 HttpListenerContext리소스가 해제됩니다. 개체를 닫거나 중단한 후에는 HttpListenerContext 해당 메서드 또는 속성을 참조할 수 없습니다. 이렇게 하면 예외가 발생합니다 ObjectDisposedException .

속성

Request

클라이언트의 리소스 요청을 나타내는 HttpListenerRequest를 가져옵니다.

Response

클라이언트의 요청에 대한 응답으로 클라이언트에 보낼 HttpListenerResponse 개체를 가져옵니다.

User

HttpListenerContext 개체가 나타내는 요청을 보낸 클라이언트의 ID, 인증 정보 및 보안 규칙을 얻는 데 사용되는 개체를 가져옵니다.

메서드

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)

적용 대상

추가 정보