2.2.3.143.2 Range (ItemOperations)
The Range element is an optional child element of the Options element in ItemOperations command requests that specifies the range of bytes that the client can receive in response to the fetch operation for a document library item. The Range element is an optional child element of the Properties element in ItemOperations command responses that specifies the actual range of bytes for an item that is contained in a given fetch operation.
Elements referenced in this section are defined in the ItemOperations namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
ItemOperations command request (section 2.2.1.10) fetch operation |
Options (section 2.2.3.125.3)
|
None |
string ([MS-ASDTYPE] section 2.7) |
0...1 (optional) |
|
ItemOperations command response fetch operation |
Properties (section 2.2.3.139.2) |
None |
string |
0...1 (optional) |
The Range element contains a string value in the format "m-n", where m is less than or equal to n, and m is the minimum value and n is the maximum value. The byte range is zero-indexed; the first byte is indicated by a 0 (zero).
The server provides a best effort at fulfilling the request. Therefore, the client cannot assume that the byte-range that is specified in the request exactly matches the byte-range that is returned in the response. The byte-range that is specified by the server in the response is the authoritative value.
If the Range element is omitted in the request, the whole item is fetched.
If the airsyncbase:FileReference element (section 2.2.3.8) is present in the request, then the Range element is the only valid child element of the Options element.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
|
Protocol version |
Element support |
|---|---|
|
2.5 |
|
|
12.0 |
Yes |
|
12.1 |
Yes |
|
14.0 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |