Skip to content

Latest commit

 

History

History
59 lines (34 loc) · 1.59 KB

httpprogress.md

File metadata and controls

59 lines (34 loc) · 1.59 KB
-api-id -api-type
T:Windows.Web.Http.HttpProgress
winrt struct

HttpProgress

-description

Contains status information on the progress of an HttpClient operation.

-struct-fields

-field Stage

The step in the progress of an HTTP connection.

-field BytesSent

The total number of bytes sent.

This value includes bytes sent as request headers.

If the operation was restarted, this value may be smaller than in the previous progress report.

-field TotalBytesToSend

The total number of data bytes to send.

If the number is unknown, this value is 0.

-field BytesReceived

The total number of bytes received.

This value includes bytes received as response headers.

If the operation was restarted, this value may be smaller than in the previous progress report.

-field TotalBytesToReceive

The total number of data bytes to receive.

If the number is unknown, this value is 0.

-field Retries

The number of retries.

-remarks

When sending (POST method) an HttpBufferContent class, the value jumps from 0% bytes sent to 100% bytes sent in one progress event, because the whole buffer is moved to lower network APIs all at once. For more detailed progress, use HttpStreamContent instead of HttpBufferContent, because streams are read and sent in smaller chunks, resulting in more progress events. E.g. 0 bytes sent, 65536 bytes sent, 131072 bytes sent, etc.

-examples

-see-also

HttpClient