UploadSettings¶

Options for sending the request headers and content, including upload progress monitoring.

Remarks:

SetupRequest might be called when redirected or retried!

Fields:¶

Size of the internal buffer, and upload progress will be fired when this size of data sent to the wire. Its default value is 4 KiB.

The stream that the plugin will use to send data to the server.

The stream can be any regular Stream implementation or a specialized one inheriting from UploadStreamBase:

A specialized UploadStreamBase for data generated on-the-fly or periodically. The request remains active until the Complete method is invoked, ensuring continuous data feed even during temporary empty states.
An UploadStreamBase implementation to convert and upload the object as JSON data. It sets the "Content-Type" header to "application/json; charset=utf-8".
An UploadStreamBase implementation representing a stream that prepares and sends data as URL-encoded form data in an HTTP request.
An UploadStreamBase based implementation of the multipart/form-data Content-Type. It's very memory-effective, streams are read into memory in chunks.

Set to false if the plugin MUST NOT dispose UploadStream after the request is finished.

Called periodically when data sent to the server.

This event is fired after the headers are sent to the server.

Called every time the request is sent out (redirected or retried).

Dispose of resources used by the UploadSettings instance.