This topic has not yet been rated - Rate this topic

WebRequest::ContentLength Property

.NET Framework 4.5

When overridden in a descendant class, gets or sets the content length of the request data being sent.

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

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

Property Value

Type: System::Int64
The number of bytes of request data being sent.

Exceptions

Exception	Condition
NotImplementedException	Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Remarks

The ContentLength property contains the number of bytes of data sent to the Internet resource by the WebRequest instance.

Note
The WebRequest class is an abstract class. The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest::Create method. For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Examples

The following example sets the ContentLength property to the amount of bytes in the outgoing byte buffer.

C++

// Set the 'ContentType' property of the WebRequest.
myWebRequest->ContentType = "application/x-www-form-urlencoded";

// Set the 'ContentLength' property of the WebRequest.
myWebRequest->ContentLength = byteArray->Length;
Stream^ newStream = myWebRequest->GetRequestStream();
newStream->Write( byteArray, 0, byteArray->Length );

// Close the Stream object.
newStream->Close();

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

WebRequest Class

System.Net Namespace

HttpWebRequest::ContentLength

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)