WebResponse.ContentLength Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

WebResponse.cs

Quando substituído em uma classe descendente, obtém ou define o tamanho do conteúdo dos dados que estão sendo recebidos.

public:
 virtual property long ContentLength { long get(); void set(long value); };

public virtual long ContentLength { get; set; }

member this.ContentLength : int64 with get, set

Public Overridable Property ContentLength As Long

Valor da propriedade

Int64

O número de bytes retornados do recurso de Internet.

Exceções

NotSupportedException

Tentativa de obter ou definir a propriedade, quando a propriedade não foi substituída em uma classe descendente.

Exemplos

O exemplo a seguir usa a ContentLength propriedade para obter o Comprimento do recurso retornado.

// Create a 'WebRequest' with the specified url.
WebRequest^ myWebRequest = WebRequest::Create( "http://www.contoso.com" );

// Send the 'WebRequest' and wait for response.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Display the content length and content type received as headers in the response object.
Console::WriteLine( "\nContent length : {0}, Content Type : {1}", myWebResponse->ContentLength, myWebResponse->ContentType );

// Release resources of response object.
myWebResponse->Close();

         // Create a 'WebRequest' with the specified url.
WebRequest myWebRequest = WebRequest.Create("http://www.contoso.com"); 

// Send the 'WebRequest' and wait for response.
WebResponse myWebResponse = myWebRequest.GetResponse(); 

// Display the content length and content type received as headers in the response object.
Console.WriteLine("\nContent length :{0}, Content Type : {1}", 
                             myWebResponse.ContentLength, 
                             myWebResponse.ContentType);  

// Release resources of response object.
myWebResponse.Close();

' Create a 'WebRequest' with the specified url. 	
Dim myWebRequest As WebRequest = WebRequest.Create("www.contoso.com")

' Send the 'WebRequest' and wait for response.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

' The ContentLength and ContentType received as headers in the response object are also exposed as properties.
   ' These provide information about the length and type of the entity body in the response.
Console.WriteLine(ControlChars.Cr + "Content length :{0}, Content Type : {1}", myWebResponse.ContentLength, myWebResponse.ContentType)
myWebResponse.Close()

Comentários

A ContentLength propriedade contém o comprimento, em bytes, da resposta do recurso da Internet. Para métodos de solicitação que contêm informações de cabeçalho, o ContentLength não inclui o comprimento das informações do cabeçalho.

Observação

A WebResponse classe é uma abstract classe . O comportamento real das instâncias em tempo de WebResponse execução é determinado pela classe descendente retornada por WebRequest.GetResponse. Para obter mais informações sobre valores padrão e exceções, consulte a documentação das classes descendentes, como HttpWebResponse e FileWebResponse.

Confira também

• ContentLength