WebResponse.ContentLength Propriedade

Definição

Quando substituído em uma classe descendente, obtém ou define o tamanho do conteúdo dos dados que estão sendo recebidos.When overridden in a descendant class, gets or sets the content length of data being received.

public:
 abstract property long ContentLength { long get(); };
public:
 virtual property long ContentLength { long get(); void set(long value); };
public abstract long ContentLength { get; }
public virtual long ContentLength { get; set; }
member this.ContentLength : int64
member this.ContentLength : int64 with get, set
Public MustOverride ReadOnly Property ContentLength As Long
Public Overridable Property ContentLength As Long

Valor da propriedade

Int64

O número de bytes retornados do recurso de Internet.The number of bytes returned from the Internet resource.

Exceções

Tentativa de obter ou definir a propriedade, quando a propriedade não foi substituída em uma classe descendente.Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Exemplos

O exemplo a seguir usa a propriedade ContentLength para obter o comprimento do recurso retornado.The following example uses the ContentLength property to obtain the Length of the resource returned.

// 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 propriedade ContentLength contém o comprimento, em bytes, da resposta do recurso da Internet.The ContentLength property contains the length, in bytes, of the response from the Internet resource. Para métodos de solicitação que contêm informações de cabeçalho, o ContentLength não inclui o comprimento das informações de cabeçalho.For request methods that contain header information, the ContentLength does not include the length of the header information.

Observação

A classe WebResponse é uma classe abstract.The WebResponse class is an abstract class. O comportamento real de instâncias de WebResponse em tempo de execução é determinado pela classe descendente retornada por WebRequest.GetResponse.The actual behavior of WebResponse instances at run time is determined by the descendant class returned by WebRequest.GetResponse. Para obter mais informações sobre valores e exceções padrão, consulte a documentação para as classes descendentes, como HttpWebResponse e FileWebResponse.For more information about default values and exceptions, please see the documentation for the descendant classes, such as HttpWebResponse and FileWebResponse.

Aplica-se a

Veja também