HttpListenerResponse.CopyFrom(HttpListenerResponse) メソッド

  • リファレンス

定義

名前空間:
System.Net
アセンブリ:
System.Net.HttpListener.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll
ソース:
HttpListenerResponse.Managed.cs
ソース:
HttpListenerResponse.Managed.cs
ソース:
HttpListenerResponse.Managed.cs

プロパティを、指定した HttpListenerResponse からこの応答へコピーします。

public:
 void CopyFrom(System::Net::HttpListenerResponse ^ templateResponse);
public void CopyFrom (System.Net.HttpListenerResponse templateResponse);
member this.CopyFrom : System.Net.HttpListenerResponse -> unit
Public Sub CopyFrom (templateResponse As HttpListenerResponse)

パラメーター

templateResponse
HttpListenerResponse

コピーする HttpListenerResponse インスタンス。

例

次のコード例では、テンプレート応答をコピーして応答を作成する方法を示します。

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

注釈

多くのプロパティを既定値から固定の新しい値のセットに定期的に変更する場合は、インスタンスを HttpListenerResponse テンプレートとして使用すると便利です。 テンプレート応答を 1 回カスタマイズし、各応答を個別に構成する代わりに、 メソッドを CopyFrom 呼び出して、テンプレート応答のプロパティ値に基づいて新しい応答を構成します。

次のプロパティは、 から templateResponse 現在のインスタンスにコピーされます。

適用対象

こちらもご覧ください