HttpBufferContent Class

  • Reference

Definition

Namespace:
Windows.Web.Http
Edit

Provides HTTP content that uses a buffer.

public ref class HttpBufferContent sealed : IClosable, IStringable, IHttpContent
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpBufferContentFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpBufferContent final : IClosable, IStringable, IHttpContent
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpBufferContentFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HttpBufferContent final : IClosable, IStringable, IHttpContent
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpBufferContentFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpBufferContent : System.IDisposable, IStringable, IHttpContent
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpBufferContentFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpBufferContent : System.IDisposable, IStringable, IHttpContent
function HttpBufferContent(content, offset, count)
Public NotInheritable Class HttpBufferContent
Implements IDisposable, IHttpContent, IStringable
Inheritance
Object Platform::Object IInspectable HttpBufferContent
Attributes
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implements
IClosable IDisposable IStringable IHttpContent

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

When sending (POST method) an HttpBufferContent class, the HttpProgress.BytesSent 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.

Constructors

HttpBufferContent(IBuffer)

Initializes a new instance of the HttpBufferContent class with the specified buffer.
HttpBufferContent(IBuffer, UInt32, UInt32)

Initializes a new instance of the HttpBufferContent class with an offset and count of bytes from the specified buffer.

Properties

Headers

Get a collection of content headers set on the HttpBufferContent.

Methods

BufferAllAsync()

Serialize the HttpBufferContent into memory as an asynchronous operation.
Close()

Closes the HttpBufferContent instance and releases allocated resources.
Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
ReadAsBufferAsync()

Serialize the HttpBufferContent to a buffer as an asynchronous operation.
ReadAsInputStreamAsync()

Serialize the HttpBufferContent and return an input stream that represents the content as an asynchronous operation.
ReadAsStringAsync()

Serialize the HttpBufferContent to a String as an asynchronous operation.
ToString()

Returns a string that represents the current HttpBufferContent object.
TryComputeLength(UInt64)

Computes the HttpBufferContent length in bytes.
WriteToStreamAsync(IOutputStream)

Write the HttpBufferContent to an output stream as an asynchronous operation.

Applies to

See also