HttpListenerResponse.ContentLength64 Proprietà

Definizione

Ottiene o imposta il numero di byte dei dati del corpo inclusi nella risposta.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

Valore della proprietà

Valore dell'intestazione Content-Length della risposta.The value of the response's Content-Length header.

Eccezioni

Il valore specificato per un'operazione di impostazione è minore di zero.The value specified for a set operation is less than zero.

La risposta è già stata inviata.The response is already being sent.

Questo oggetto è chiuso.This object is closed.

Esempi

Nell'esempio di codice riportato di seguito viene illustrata l'impostazione del valore di questa proprietà.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

Commenti

L'intestazione Content-Length esprime la lunghezza, in byte, dei dati del corpo della risposta.The Content-Length header expresses the length, in bytes, of the response's body data. Quando si usa un formato che non invia i dati suddivisi in blocchi o non elaborati, è necessario impostare la proprietà ContentLength64.When using a format that does not send the data chunked or raw, you must set the ContentLength64 property. In caso contrario, il HttpListener non invia i dati di risposta.If you do not, the HttpListener does not send the response data.

Per un elenco completo delle intestazioni di risposta, vedere l'enumerazione HttpResponseHeader.For a complete list of response headers, see the HttpResponseHeader enumeration.

Si applica a

Vedi anche