HttpContent Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Базовый класс, представляющий текст сущности HTTP и заголовки содержимого.
public ref class HttpContent abstract : IDisposable
public abstract class HttpContent : IDisposable
type HttpContent = class
interface IDisposable
Public MustInherit Class HttpContent
Implements IDisposable
- Наследование
-
HttpContent
- Производный
- Реализации
В следующем примере показана настраиваемая реализация HttpContent. Некоторые методы, несмотря на то, что они определены как virtual
и не abstract
, по-прежнему должны быть переопределены в реализации для оптимального поведения.
public class MyContent : HttpContent
{
private readonly string _data;
public MyContent(string data)
{
_data = data;
}
// Minimal implementation needed for an HTTP request content,
// i.e. a content that will be sent via HttpClient, contains the 2 following methods.
protected override bool TryComputeLength(out long length)
{
// This content doesn't support pre-computed length and
// the request will NOT contain Content-Length header.
length = 0;
return false;
}
// SerializeToStream* methods are internally used by CopyTo* methods
// which in turn are used to copy the content to the NetworkStream.
protected override Task SerializeToStreamAsync(Stream stream, TransportContext? context)
=> stream.WriteAsync(Encoding.UTF8.GetBytes(_data)).AsTask();
// Override SerializeToStreamAsync overload with CancellationToken
// if the content serialization supports cancellation, otherwise the token will be dropped.
protected override Task SerializeToStreamAsync(Stream stream, TransportContext? context, CancellationToken cancellationToken)
=> stream.WriteAsync(Encoding.UTF8.GetBytes(_data), cancellationToken).AsTask();
// In rare cases when synchronous support is needed, e.g. synchronous CopyTo used by HttpClient.Send,
// implement synchronous version of SerializeToStream.
protected override void SerializeToStream(Stream stream, TransportContext? context, CancellationToken cancellationToken)
=> stream.Write(Encoding.UTF8.GetBytes(_data));
// CreateContentReadStream* methods, if implemented, will be used by ReadAsStream* methods
// to get the underlying stream and avoid buffering.
// These methods will not be used by HttpClient on a custom content.
// They are for content receiving and HttpClient uses its own internal implementation for an HTTP response content.
protected override Task<Stream> CreateContentReadStreamAsync()
=> Task.FromResult<Stream>(new MemoryStream(Encoding.UTF8.GetBytes(_data)));
// Override CreateContentReadStreamAsync overload with CancellationToken
// if the content serialization supports cancellation, otherwise the token will be dropped.
protected override Task<Stream> CreateContentReadStreamAsync(CancellationToken cancellationToken)
=> Task.FromResult<Stream>(new MemoryStream(Encoding.UTF8.GetBytes(_data))).WaitAsync(cancellationToken);
// In rare cases when synchronous support is needed, e.g. synchronous ReadAsStream,
// implement synchronous version of CreateContentRead.
protected override Stream CreateContentReadStream(CancellationToken cancellationToken)
=> new MemoryStream(Encoding.UTF8.GetBytes(_data));
}
Существует различные содержимое HTTP, которое можно использовать. К ним относятся следующие.
ByteArrayContent — содержимое, представленное массивом байтов, также служит базовым классом для StringContent и FormUrlEncodedContent.
StringContent — строковое содержимое по умолчанию сериализовано как
text/plain
Content-Type
с кодировкойUTF-8
.FormUrlEncodedContent — содержимое с кортежами name/value, сериализованным как
application/x-www-form-urlencoded
Content-Type
.MultipartContent — содержимое, которое может сериализовать несколько различных объектов HttpContent в виде
multipart/*
Content-Type
.JsonContent — содержимое, сериализующее объекты как
application/json
Content-Type
с кодировкойUTF-8
по умолчанию.
Класс контента HTTP может быть производным пользователем для предоставления пользовательской логики сериализации контента.
Http |
Инициализирует новый экземпляр класса HttpContent. |
Headers |
Возвращает заголовки содержимого HTTP, как определено в RFC 2616. |
Copy |
Сериализует http-содержимое в поток байтов и копирует его в |
Copy |
Сериализируйте содержимое HTTP в поток байтов и копирует его в объект потока, предоставленный в качестве параметра |
Copy |
Сериализируйте содержимое HTTP в поток байтов и копирует его в объект потока, предоставленный в качестве параметра |
Copy |
Сериализируйте содержимое HTTP в поток байтов и копирует его в объект потока, предоставленный в качестве параметра |
Copy |
Сериализируйте содержимое HTTP в поток байтов и копирует его в объект потока, предоставленный в качестве параметра |
Create |
Сериализует содержимое HTTP в поток памяти. |
Create |
Сериализуйте содержимое HTTP в поток памяти в виде асинхронной операции. |
Create |
Сериализует содержимое HTTP в поток памяти в виде асинхронной операции. |
Dispose() |
Освобождает неуправляемые ресурсы и удаляет управляемые ресурсы, используемые HttpContent. |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые HttpContent, и при необходимости удаляет управляемые ресурсы. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Get |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
Get |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
Load |
Сериализуйте содержимое HTTP в буфер памяти в виде асинхронной операции. |
Load |
Сериализуйте содержимое HTTP в буфер памяти в виде асинхронной операции. |
Load |
Сериализуйте содержимое HTTP в буфер памяти в виде асинхронной операции. |
Load |
Сериализуйте содержимое HTTP в буфер памяти в виде асинхронной операции. |
Memberwise |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
Read |
Сериализируйте содержимое HTTP в массив байтов в виде асинхронной операции. |
Read |
Сериализируйте содержимое HTTP в массив байтов в виде асинхронной операции. |
Read |
Сериализует содержимое HTTP и возвращает поток, представляющий содержимое. |
Read |
Сериализует содержимое HTTP и возвращает поток, представляющий содержимое. |
Read |
Сериализируйте содержимое HTTP и верните поток, представляющий содержимое как асинхронную операцию. |
Read |
Сериализируйте содержимое HTTP и верните поток, представляющий содержимое как асинхронную операцию. |
Read |
Сериализуйте содержимое HTTP в строку в виде асинхронной операции. |
Read |
Сериализуйте содержимое HTTP в строку в виде асинхронной операции. |
Serialize |
При переопределении в производном классе сериализует содержимое HTTP в поток. В противном случае вызывает NotSupportedException. |
Serialize |
Сериализуйте содержимое HTTP в поток в виде асинхронной операции. |
Serialize |
Сериализуйте содержимое HTTP в поток в виде асинхронной операции. |
To |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Try |
Определяет, имеет ли содержимое HTTP допустимую длину в байтах. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции перечисления. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции перечисления. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции перечисления. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции. |
Read |
Считывает содержимое HTTP и возвращает значение, которое приводит к десериализации содержимого в формате JSON в асинхронной операции. |
Өнім | Нұсқалар |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: