WebResponse.ContentLength Propriedade

Definição

Espaço de Nomes:
System.Net
Assemblagens:
System.dll, System.Net.Requests.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Quando sobrescrito numa classe descendente, obtém ou define o comprimento do conteúdo dos dados recebidos.

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 de Propriedade

Int64

O número de bytes devolvidos do recurso da Internet.

Exceções

NotSupportedException

Qualquer tentativa é feita para obter ou definir a propriedade quando a propriedade não é sobreposta numa classe descendente.

Exemplos

O exemplo seguinte utiliza a ContentLength propriedade para obter o Comprimento do recurso devolvido.


         // 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()

Observações

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

Note

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

Aplica-se a

Ver também