HttpListenerResponse.Close Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wysyła odpowiedź do klienta i zwalnia zasoby przechowywane przez to HttpListenerResponse wystąpienie.
Przeciążenia
| Close() |
Wysyła odpowiedź do klienta i zwalnia zasoby przechowywane przez to HttpListenerResponse wystąpienie. |
| Close(Byte[], Boolean) |
Zwraca określoną tablicę bajtów do klienta i zwalnia zasoby przechowywane przez to HttpListenerResponse wystąpienie. |
Close()
Wysyła odpowiedź do klienta i zwalnia zasoby przechowywane przez to HttpListenerResponse wystąpienie.
public:
void Close();[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void Close ();public void Close ();[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Close : unit -> unitmember this.Close : unit -> unitPublic Sub Close ()- Atrybuty
Przykłady
W poniższym przykładzie kodu pokazano wywołanie tej metody w celu wysłania Forbidden odpowiedzi (403) do klienta.
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
Uwagi
Ta metoda zamyka strumień odpowiedzi i HttpListenerRequest skojarzony z odpowiedzią.
Zobacz też
Dotyczy
Close(Byte[], Boolean)
Zwraca określoną tablicę bajtów do klienta i zwalnia zasoby przechowywane przez to HttpListenerResponse wystąpienie.
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 -> unitmember this.Close : byte[] * bool -> unitPublic Sub Close (responseEntity As Byte(), willBlock As Boolean)Parametry
- willBlock
- Boolean
true aby zablokować wykonywanie podczas opróżniania strumienia do klienta; w przeciwnym razie , false.
- Atrybuty
Wyjątki
responseEntity to null.
Ten obiekt jest zamknięty.
Przykłady
W poniższym przykładzie kodu pokazano wywołanie tej metody.
// 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
Uwagi
Jeśli wysyłasz dane treści z odpowiedzią, możesz użyć tej metody, aby wysłać je jako tablicę Byte zamiast zapisywać dane treści do OutputStream właściwości i wywoływać metodę Close .
Ta metoda zamyka strumień odpowiedzi i HttpListenerRequest skojarzony z odpowiedzią.
Jeśli false parametr jest określony jako willBlock, metoda zwraca natychmiast i połączenie jest zamykane asynchronicznie po wysłaniu danych.
Uwaga
Jeśli obiekt wywołujący jest zamykany asynchronicznie, nie można określić, kiedy dane zostały wysłane. Oprócz tego, odłączanie HttpListenerResponseHttpListenerContext elementu lub HttpListener może zamknąć połączenie przed wysłaniem wszystkich danych.
