HttpListenerContext 클래스

정의

HttpListener 클래스에서 사용되는 요청 및 응답 개체에 액세스할 수 있도록 합니다.Provides access to the request and response objects used by the HttpListener class. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class HttpListenerContext sealed
public sealed class HttpListenerContext
type HttpListenerContext = class
Public NotInheritable Class HttpListenerContext
상속
HttpListenerContext

예제

다음 코드 예제에서는 클라이언트 요청에 대 한 사용자 정보를 표시 합니다.The following code example displays the user information for a client request.

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 개체입니다.This class provides the information related to a client's Hypertext Transfer Protocol (HTTP) request being processed by an HttpListener object. 이 클래스에 사용할 수 있는 메서드는 HttpListener WebSocket 연결을 허용 하는 개체입니다.This class also has methods that allow an HttpListener object to accept a WebSocket connection.

합니다 GetContext 의 인스턴스를 반환 하는 메서드를 HttpListenerContext 클래스입니다.The GetContext method returns instances of the HttpListenerContext class. 클라이언트 요청을 나타내는 개체를 가져오려면는 Request 속성입니다.To get the object that represents the client request, use the Request property. 클라이언트에 전송 될 응답을 나타내는 개체를 가져와 HttpListener를 사용 하 여는 Response 속성입니다.To get the object that represents the response that will be sent to the client by the HttpListener, use the Response property. 로그인 이름 및 해당의 인증 여부,와 같은 요청을 보내는 클라이언트에 대 한 사용자 정보 속성을 쿼리할 수 있습니다 합니다 IPrincipal 에서 반환 된 개체는 User 속성입니다.To get user information about the client sending the request, such as its login name and whether it has been authenticated, you can query the properties in the IPrincipal object returned by the User property.

닫기는 HttpListenerContext 개체는 클라이언트에 응답을 보내고에서 사용 하는 리소스를 해제 합니다 HttpListenerContext합니다.Closing an HttpListenerContext object sends the response to the client and frees any resources used by the HttpListenerContext. 중단을 HttpListenerContext 개체에서 사용 하는 리소스를 해제 하지 이미 전송 된 경우 클라이언트에 대 한 응답을 삭제 합니다 HttpListenerContext합니다.Aborting an HttpListenerContext object discards the response to the client if it has not already been sent, and frees any resources used by the HttpListenerContext. 닫기 또는 중단 후는 HttpListenerContext 개체의 메서드 또는 속성을 참조할 수 없습니다.After closing or aborting an HttpListenerContext object, you cannot reference its methods or properties. 이렇게 하면 받게는 ObjectDisposedException 예외입니다.If you do so, you will receive an ObjectDisposedException exception.

속성

Request

클라이언트의 리소스 요청을 나타내는 HttpListenerRequest를 가져옵니다.Gets the HttpListenerRequest that represents a client's request for a resource.

Response

클라이언트의 요청에 대한 응답으로 클라이언트에 보낼 HttpListenerResponse 개체를 가져옵니다.Gets the HttpListenerResponse object that will be sent to the client in response to the client's request.

User

HttpListenerContext 개체가 나타내는 요청을 보낸 클라이언트의 ID, 인증 정보 및 보안 규칙을 얻는 데 사용되는 개체를 가져옵니다.Gets an object used to obtain identity, authentication information, and security roles for the client whose request is represented by this HttpListenerContext object.

메서드

AcceptWebSocketAsync(String)

WebSocket 연결을 비동기 작업으로 허용합니다.Accept a WebSocket connection as an asynchronous operation.

AcceptWebSocketAsync(String, Int32, TimeSpan)

지원되는 WebSocket 하위 프로토콜, 수신 버퍼 크기 및 WebSocket 연결 유지 간격을 비동기 작업으로 지정하는 WebSocket 연결을 허용합니다.Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, and WebSocket keep-alive interval as an asynchronous operation.

AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)

지원되는 WebSocket 하위 프로토콜, 수신 버퍼 크기, WebSocket 연결 유지 간격 및 내부 버퍼를 비동기 작업으로 지정하는 WebSocket 연결을 허용합니다.Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, WebSocket keep-alive interval, and the internal buffer as an asynchronous operation.

AcceptWebSocketAsync(String, TimeSpan)

지원되는 WebSocket 하위 프로토콜 및 WebSocket Keep-Alive 간격을 비동기 작업으로 지정하는 WebSocket 연결을 허용합니다.Accept a WebSocket connection specifying the supported WebSocket sub-protocol and WebSocket keep-alive interval as an asynchronous operation.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

적용 대상

추가 정보