RangeHeaderValue Class

RangeHeaderValue Class

.NET Framework 4.6 and 4.5

Represents a Range header value.

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


public class RangeHeaderValue : ICloneable


Initializes a new instance of the RangeHeaderValue class.

System_CAPS_pubmethodRangeHeaderValue(Nullable<Int64>, Nullable<Int64>)

Initializes a new instance of the RangeHeaderValue class with a byte range.


Gets the ranges specified from the RangeHeaderValue object.


Gets the unit from the RangeHeaderValue object.


Determines whether the specified Object is equal to the current RangeHeaderValue object.(Overrides Object.Equals(Object).)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Serves as a hash function for an RangeHeaderValue object.(Overrides Object.GetHashCode().)


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)


Converts a string to an RangeHeaderValue instance.


Returns a string that represents the current RangeHeaderValue object.(Overrides Object.ToString().)

System_CAPS_pubmethodSystem_CAPS_staticTryParse(String, RangeHeaderValue)

Determines whether a string is valid RangeHeaderValue information.


Creates a new object that is a copy of the current RangeHeaderValue instance.

The RangeHeaderValue class provides support for the Range header as defined in RFC 2616 by the IETF.

Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. However, not all clients and servers need to support byte-range operations.

The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Servers are not required to support Range header requests.

An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

Range: bytes=0-99\r\n\r\n

A HTTP server indicates support for Range headers with the Accept-Ranges header. An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

Accept-Ranges: bytes\r\n\r\n

If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

Accept-Ranges: none\r\n\r\n

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 4.5
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
© 2015 Microsoft