Export (0) Print
Expand All

RangeHeaderValue Class

.NET Framework 4.5

Represents a Range header value.

System.Object
  System.Net.Http.Headers.RangeHeaderValue

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

public class RangeHeaderValue : ICloneable

The RangeHeaderValue type exposes the following members.

  NameDescription
Public methodSupported in .NET for Windows Store appsRangeHeaderValue()Initializes a new instance of the RangeHeaderValue class.
Public methodSupported in .NET for Windows Store appsRangeHeaderValue(Nullable<Int64>, Nullable<Int64>)Initializes a new instance of the RangeHeaderValue class with a byte range.
Top

  NameDescription
Public propertySupported in .NET for Windows Store appsRangesGets the ranges specified from the RangeHeaderValue object.
Public propertySupported in .NET for Windows Store appsUnitGets the unit from the RangeHeaderValue object.
Top

  NameDescription
Public methodSupported in .NET for Windows Store appsEqualsDetermines whether the specified Object is equal to the current RangeHeaderValue object. (Overrides Object.Equals(Object).)
Protected methodSupported in .NET for Windows Store appsFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported in .NET for Windows Store appsGetHashCodeServes as a hash function for an RangeHeaderValue object. (Overrides Object.GetHashCode().)
Public methodSupported in .NET for Windows Store appsGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodSupported in .NET for Windows Store appsMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodStatic memberSupported in .NET for Windows Store appsParseConverts a string to an RangeHeaderValue instance.
Public methodSupported in .NET for Windows Store appsToStringReturns a string that represents the current RangeHeaderValue object. (Overrides Object.ToString().)
Public methodStatic memberSupported in .NET for Windows Store appsTryParseDetermines whether a string is valid RangeHeaderValue information.
Top

  NameDescription
Explicit interface implemetationPrivate methodICloneable.CloneCreates a new object that is a copy of the current RangeHeaderValue instance.
Top

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

.NET Framework

Supported in: 4.6, 4.5

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Windows Phone 8.1, Windows 8.1, Windows Server 2012 R2, 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.

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