RangeHeaderValue Class

Definition

Namespace:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

Source:

RangeHeaderValue.cs

Represents a Range header value.

public ref class RangeHeaderValue : ICloneable

public class RangeHeaderValue : ICloneable

type RangeHeaderValue = class
    interface ICloneable

Public Class RangeHeaderValue
Implements ICloneable

Inheritance

Object

RangeHeaderValue

Implements

ICloneable

Remarks

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

Constructors

RangeHeaderValue()	Initializes a new instance of the RangeHeaderValue class.
RangeHeaderValue(Nullable<Int64>, Nullable<Int64>)	Initializes a new instance of the RangeHeaderValue class with a byte range.

Properties

Ranges	Gets the ranges specified from the RangeHeaderValue object.
Unit	Gets the unit from the RangeHeaderValue object.

Methods

Equals(Object)	Determines whether the specified Object is equal to the current RangeHeaderValue object.
GetHashCode()	Serves as a hash function for an RangeHeaderValue object.
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
Parse(String)	Converts a string to an RangeHeaderValue instance.
ToString()	Returns a string that represents the current RangeHeaderValue object.
TryParse(String, RangeHeaderValue)	Determines whether a string is valid RangeHeaderValue information.

Explicit Interface Implementations

ICloneable.Clone()

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