HttpListenerResponse.CopyFrom(HttpListenerResponse) Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.HttpListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: HttpListenerResponse.Managed.cs

Quelle:: HttpListenerResponse.Managed.cs

Quelle:: HttpListenerResponse.Managed.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Kopiert Eigenschaften aus der angegebenen HttpListenerResponse in diese Antwort.

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)

Parameter

templateResponse: HttpListenerResponse

Die zu kopierende HttpListenerResponse-Instanz.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Antwort durch Kopieren einer Vorlagenantwort.

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

Hinweise

Wenn Sie regelmäßig viele Eigenschaften von ihren Standardwerten in einen festen Satz neuer Werte ändern, ist es praktisch, eine HttpListenerResponse Instanz als Vorlage zu verwenden. Passen Sie die Vorlagenantwort einmal an, und rufen Sie CopyFrom die -Methode auf, anstatt jede Antwort einzeln zu konfigurieren, um eine neue Antwort basierend auf Eigenschaftenwerten in der Vorlagenantwort zu konfigurieren.

Die folgenden Eigenschaften werden aus templateResponse der aktuellen Instanz kopiert.

Gilt für:

Freigeben über