다음을 통해 공유

HttpListenerResponse.Close 메서드

  • 참조

정의

네임스페이스:
System.Net
어셈블리:
System.Net.HttpListener.dll
어셈블리:
System.dll
어셈블리:
netstandard.dll

클라이언트에 응답을 보내고 이 HttpListenerResponse 인스턴스에서 보유한 리소스를 해제합니다.

오버로드

Close()

클라이언트에 응답을 보내고 이 HttpListenerResponse 인스턴스에서 보유한 리소스를 해제합니다.
Close(Byte[], Boolean)

지정된 바이트 배열을 클라이언트에 반환하고 이 HttpListenerResponse 인스턴스에서 보유한 리소스를 해제합니다.

Close()

Source:
HttpListenerResponse.Managed.cs
Source:
HttpListenerResponse.Managed.cs
Source:
HttpListenerResponse.Managed.cs

클라이언트에 응답을 보내고 이 HttpListenerResponse 인스턴스에서 보유한 리소스를 해제합니다.

public:
 void Close();
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void Close ();
public void Close ();
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Close : unit -> unit
member this.Close : unit -> unit
Public Sub Close ()
특성
UnsupportedOSPlatformAttribute

예제

다음 코드 예제에서는 클라이언트에 (403) 응답을 보내기 Forbidden 위해이 메서드를 호출 하는 방법을 보여 줍니다.

static string message403;
static HttpListenerResponse preMade403Response;
static void SendBadCertificateResponse(HttpListenerResponse response)
{
    if (preMade403Response == null)
    {
        // Set up an authentication error response template.
        response.StatusCode = (int)HttpStatusCode.Forbidden;
        response.StatusDescription = "403 Forbidden";
        response.ProtocolVersion = new Version("1.1");
        response.SendChunked = false;

        preMade403Response = response;
    }
    else
    {
        response.CopyFrom(preMade403Response);
    }

    // The response body cannot be saved in the template.

    StringBuilder message = new StringBuilder();
    message.Append("<HTML><BODY>");
    message.Append("<p> Error message 403: Access is denied due to a missing or invalid client certificate.</p>");
    message.Append("</BODY></HTML>");
    message403 = message.ToString();

    // Turn the error message into a byte array using the
    // encoding from the response when present.
    System.Text.Encoding encoding = response.ContentEncoding;
    if (encoding == null)
    {
        encoding = System.Text.Encoding.UTF8;
        response.ContentEncoding = encoding;
    }

    byte[] buffer = encoding.GetBytes(message403);
    response.ContentLength64 = buffer.Length;
    // Write the error message.
    System.IO.Stream stream = response.OutputStream;
    stream.Write(buffer, 0, buffer.Length);
    // Send the response.
    response.Close();
}

Private Shared message403 As String
Private Shared preMade403Response As HttpListenerResponse
Private Shared Sub SendBadCertificateResponse(ByVal response As HttpListenerResponse)
    
    If preMade403Response Is Nothing Then
        ' Set up an authentication error response template.
        response.StatusCode = Cint(HttpStatusCode.Forbidden)
        response.StatusDescription = "403 Forbidden"
        response.ProtocolVersion = New Version("1.1")
        response.SendChunked = False
    Else
        response.CopyFrom(preMade403Response) 
    End If
    
    ' The response body cannot be saved in the template.
    Dim message As New StringBuilder()
    message.Append("<HTML><BODY>")
    message.Append("<p> Error message 403: Access is denied due to a missing or invalid client certificate.</p>")
    message.Append("</BODY></HTML>")
    message403 = message.ToString()

    ' Turn the error message into a byte array using the 
    ' encoding from the response when present.
    Dim encoding As System.Text.Encoding = response.ContentEncoding
    If encoding Is Nothing Then
        encoding = System.Text.Encoding.UTF8
        response.ContentEncoding = encoding
    End If

    Dim buffer() As Byte = encoding.GetBytes(message403)
    response.ContentLength64 = buffer.Length
    ' Write the error message.
    Dim stream As System.IO.Stream = response.OutputStream
    stream.Write(buffer, 0, buffer.Length)
    ' Send the response.
    response.Close()
End Sub

설명

이 메서드는 응답 스트림 및 응답과 HttpListenerRequest 연결된 를 닫습니다.

추가 정보

적용 대상

Close(Byte[], Boolean)

Source:
HttpListenerResponse.Managed.cs
Source:
HttpListenerResponse.Managed.cs
Source:
HttpListenerResponse.Managed.cs

지정된 바이트 배열을 클라이언트에 반환하고 이 HttpListenerResponse 인스턴스에서 보유한 리소스를 해제합니다.

public:
 void Close(cli::array <System::Byte> ^ responseEntity, bool willBlock);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void Close (byte[] responseEntity, bool willBlock);
public void Close (byte[] responseEntity, bool willBlock);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Close : byte[] * bool -> unit
member this.Close : byte[] * bool -> unit
Public Sub Close (responseEntity As Byte(), willBlock As Boolean)

매개 변수

responseEntity
Byte[]

클라이언트에 보낼 응답이 들어 있는 Byte 배열입니다.

willBlock
Boolean

스트림을 클라이언트로 플러시하는 동안 실행을 차단하려면 true이고, 그렇지 않으면 false입니다.

특성
UnsupportedOSPlatformAttribute

예외

ArgumentNullException

responseEntity이(가) null인 경우

ObjectDisposedException

이 개체가 닫혀 있는 경우

예제

다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample2(string[] prefixes)
{
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length == 0)
      throw new ArgumentException("prefixes");

    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request.
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    // Obtain a response object.
    HttpListenerResponse response = context.Response;
    // Construct a response.
    string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length;
    // Demonstrate using the close overload that takes an
    // entity body.
    // Specify true to block while data is transmitted.
    response.Close(buffer, true);
    listener.Stop();
}

Public Shared Sub SimpleListenerExample2(ByVal prefixes As String())
    ' URI prefixes are required,
    ' for example "http://contoso.com:8080/index/".
    If prefixes Is Nothing Or prefixes.Length = 0 Then
        Throw New ArgumentException("prefixes")
    End If

    ' Create a listener
    Dim listener As HttpListener = New HttpListener()
    ' Add the prefixes
    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next

    listener.Start()
    Console.WriteLine("Listening...")
    ' Note: The GetContext method blocks while waiting for a request. 
    Dim context As HttpListenerContext = listener.GetContext()
    Dim request As HttpListenerRequest = context.Request
    ' Obtain a response object.
    Dim response As HttpListenerResponse = context.Response
    ' Construct a response
    Dim responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
    Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
    ' Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length
    ' Demonstrate using the close overload that takes an 
    ' entity body.
    ' Specify true to block while data Is transmitted.
    response.Close(buffer, True)
    listener.Stop()
End Sub

설명

응답과 함께 본문 데이터를 보내는 경우 본문 데이터를 속성에 쓰고 메서드를 Byte 호출 Close 하는 대신 이 메서드를 OutputStream 사용하여 배열로 보낼 수 있습니다.

이 메서드는 응답 스트림 및 응답과 HttpListenerRequest 연결된 를 닫습니다.

가 로 willBlock지정된 경우 false 메서드는 즉시 반환되고 데이터가 전송되면 연결이 비동기적으로 닫힙니다.

참고

비동기적으로 닫는 경우 호출자가 데이터를 보낸 시기를 확인할 수 없습니다. 그 외에도 를 HttpListenerContext 삭제HttpListenerResponse하거나 HttpListener 모든 데이터가 전송되기 전에 연결을 닫을 수 있습니다.

추가 정보

적용 대상