HttpListenerResponse.ContentLength64 HttpListenerResponse.ContentLength64 HttpListenerResponse.ContentLength64 HttpListenerResponse.ContentLength64 Property

定義

取得或設定回應中所包含之主體資料的位元組數。Gets or sets the number of bytes in the body data included in the response.

public:
 property long ContentLength64 { long get(); void set(long value); };
public long ContentLength64 { get; set; }
member this.ContentLength64 : int64 with get, set
Public Property ContentLength64 As Long

屬性值

回應之 Content-Length 標頭的值。The value of the response's Content-Length header.

例外狀況

為設定作業指定的值小於零。The value specified for a set operation is less than zero.

範例

下列程式碼範例將示範如何設定這個屬性的值。The following code example demonstrates setting the value of this property.

// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample(string[] prefixes)
{
    if (!HttpListener.IsSupported)
    {
        Console.WriteLine ("Windows XP SP2 or Server 2003 is required to use the HttpListener class.");
        return;
    }
    // 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;
    System.IO.Stream output = response.OutputStream;
    output.Write(buffer,0,buffer.Length);
    // You must close the output stream.
    output.Close();
    listener.Stop();
}
Public Shared Sub SimpleListenerExample(prefixes As String())
    If Not HttpListener.IsSupported Then
        Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class.")
        Return
    End If
    ' 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 = New HttpListener()

    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()
    Console.WriteLine("Listening...")
    ' Obtain a response object
    Dim request As HttpListenerRequest = context.Request
    ' Construct a response.
    Dim response As HttpListenerResponse = context.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
    Dim output As System.IO.Stream = response.OutputStream
    output.Write(buffer, 0, buffer.Length)
    'You must close the output stream.
    output.Close()
    listener.Stop()
End Sub

備註

Content-Length標頭表示回應的本文資料長度 (以位元組為單位)。The Content-Length header expresses the length, in bytes, of the response's body data. 當使用不會傳送資料區塊或原始的格式時, 您必須設定ContentLength64屬性。When using a format that does not send the data chunked or raw, you must set the ContentLength64 property. 如果不這麼做, HttpListener就不會傳送回應資料。If you do not, the HttpListener does not send the response data.

如需回應標頭的完整清單, 請HttpResponseHeader參閱列舉。For a complete list of response headers, see the HttpResponseHeader enumeration.

適用於

另請參閱