WebResponse.ContentLength-Eigenschaft

Artikel
08/20/2007

Ruft beim Überschreiben in einer abgeleiteten Klasse die Inhaltslänge der empfangenen Daten ab oder legt diese fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overridable Property ContentLength As Long
'Usage
Dim instance As WebResponse
Dim value As Long

value = instance.ContentLength

instance.ContentLength = value

public virtual long ContentLength { get; set; }

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

/** @property */
public long get_ContentLength ()

/** @property */
public void set_ContentLength (long value)

public function get ContentLength () : long

public function set ContentLength (value : long)

Eigenschaftenwert

Die Anzahl der von der Internetressource zurückgegebenen Bytes.

Ausnahmen

Ausnahmetyp	Bedingung
NotSupportedException	Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer abgeleiteten Klasse nicht überschrieben wurde.

Hinweise

Die ContentLength-Eigenschaft enthält die Länge der Antwort von der Internetressource in Bytes. Bei Anforderungsmethoden mit Headerinformationen ist in der ContentLength die Länge der Headerinformationen nicht miteinbezogen.

Hinweis

Die WebResponse-Klasse ist eine abstract Klasse. Das tatsächliche Verhalten von WebResponse-Instanzen zur Laufzeit wird von der abgeleiteten Klasse bestimmt, die von WebRequest.GetResponse zurückgegeben wird. Weitere Informationen über Standardwerte und Ausnahmen finden Sie in der Dokumentation zu den abgeleiteten Klassen, z. B. HttpWebResponse und FileWebResponse.

Beispiel

Im folgenden Beispiel wird mithilfe der ContentLength-Eigenschaft die Länge der zurückgegebenen Ressource abgerufen.

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

         // Create a 'WebRequest' with the specified url.
WebRequest myWebRequest = WebRequest.Create("https://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( "https://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("https://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}", 
    System.Convert.ToString(myWebResponse.get_ContentLength()),
    System.Convert.ToString(myWebResponse.get_ContentType()));
// Release resources of response object.
myWebResponse.Close();

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

WebResponse-Klasse
WebResponse-Member
System.Net-Namespace
HttpWebResponse.ContentLength-Eigenschaft

Freigeben über