HttpContent Sınıf

Tanım

Ad Alanı:

System.Net.Http

Bütünleştirilmiş Kod:

System.Net.Http.dll

Kaynak:

HttpContent.cs

HTTP varlık gövdesini ve içerik üst bilgilerini temsil eden temel sınıf.

public ref class HttpContent abstract : IDisposable

public abstract class HttpContent : IDisposable

type HttpContent = class
    interface IDisposable

Public MustInherit Class HttpContent
Implements IDisposable

Devralma

Object

HttpContent

Türetilmiş

System.Net.Http.ByteArrayContent

System.Net.Http.Json.JsonContent

System.Net.Http.MultipartContent

System.Net.Http.ReadOnlyMemoryContent

System.Net.Http.StreamContent

Uygulamalar

IDisposable

Örnekler

Aşağıdaki örnekte özel uygulaması gösterilmektedir HttpContent. bazı yöntemler, olarak virtual tanımlanmalarına rağmen ve değil abstract, en iyi davranış için uygulamada yine de geçersiz kılınmalıdır.

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));
}

Açıklamalar

Kullanılabilecek çeşitli HTTP içeriği vardır. Bunlar aşağıdakileri içerir.

1. ByteArrayContent- Bir bayt dizisiyle temsil edilen içerik, ve FormUrlEncodedContentiçin StringContent bir temel sınıf olarak da görev görür.

2. StringContent- Varsayılan olarak kodlamada UTF-8 olduğu gibi text/plainContent-Type seri hale getirilmiş dize tabanlı içerik.

3. FormUrlEncodedContent- Ad/değer demetlerinin seri hale getirildiği bir içerik.application/x-www-form-urlencodedContent-Type

4. MultipartContent - Birden çok farklı HttpContent nesneyi olarak multipart/*Content-Typeseri hale getirebilen içerik.

5. JsonContent- Nesneleri varsayılan olarak kodlamada UTF-8 olduğu gibi application/jsonContent-Type seri hale getiren içerik.

HTTP içerik sınıfı, özel içerik serileştirme mantığı sağlamak için bir kullanıcı tarafından türetilebilir.

Oluşturucular

HttpContent()

HttpContent sınıfının yeni bir örneğini başlatır.

Özellikler

Headers

RFC 2616'da tanımlandığı gibi HTTP içerik üst bilgilerini alır.

Yöntemler

CopyTo(Stream, TransportContext, CancellationToken)	HTTP içeriğini bayt akışına seri hale getirerek içine streamkopyalar.
CopyToAsync(Stream)	HTTP içeriğini bayt akışı halinde seri hale getirin ve parametre olarak sağlanan akış nesnesine stream kopyalar.
CopyToAsync(Stream, CancellationToken)	HTTP içeriğini bayt akışı halinde seri hale getirin ve parametre olarak sağlanan akış nesnesine stream kopyalar.
CopyToAsync(Stream, TransportContext)	HTTP içeriğini bayt akışı halinde seri hale getirin ve parametre olarak sağlanan akış nesnesine stream kopyalar.
CopyToAsync(Stream, TransportContext, CancellationToken)	HTTP içeriğini bayt akışı halinde seri hale getirin ve parametre olarak sağlanan akış nesnesine stream kopyalar.
CreateContentReadStream(CancellationToken)	HTTP içeriğini bir bellek akışına serileştirir.
CreateContentReadStreamAsync()	HTTP içeriğini zaman uyumsuz bir işlem olarak bir bellek akışına seri hale getirme.
CreateContentReadStreamAsync(CancellationToken)	HTTP içeriğini zaman uyumsuz bir işlem olarak bir bellek akışına serileştirir.
Dispose()	Yönetilmeyen kaynakları serbest bırakır ve tarafından HttpContentkullanılan yönetilen kaynakları atılır.
Dispose(Boolean)	tarafından HttpContent kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları atılır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadIntoBufferAsync()	HTTP içeriğini zaman uyumsuz bir işlem olarak bir bellek arabelleğine seri hale getirme.
LoadIntoBufferAsync(Int64)	HTTP içeriğini zaman uyumsuz bir işlem olarak bir bellek arabelleğine seri hale getirme.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ReadAsByteArrayAsync()	HTTP içeriğini zaman uyumsuz bir işlem olarak bir bayt dizisine seri hale getirme.
ReadAsByteArrayAsync(CancellationToken)	HTTP içeriğini zaman uyumsuz bir işlem olarak bir bayt dizisine seri hale getirme.
ReadAsStream()	HTTP içeriğini seri hale getirir ve içeriği temsil eden bir akış döndürür.
ReadAsStream(CancellationToken)	HTTP içeriğini seri hale getirir ve içeriği temsil eden bir akış döndürür.
ReadAsStreamAsync()	HTTP içeriğini seri hale getirme ve içeriği zaman uyumsuz bir işlem olarak temsil eden bir akış döndürme.
ReadAsStreamAsync(CancellationToken)	HTTP içeriğini seri hale getirme ve içeriği zaman uyumsuz bir işlem olarak temsil eden bir akış döndürme.
ReadAsStringAsync()	HTTP içeriğini zaman uyumsuz bir işlem olarak bir dizeye seri hale getirme.
ReadAsStringAsync(CancellationToken)	HTTP içeriğini zaman uyumsuz bir işlem olarak bir dizeye seri hale getirme.
SerializeToStream(Stream, TransportContext, CancellationToken)	Türetilmiş bir sınıfta geçersiz kılındığında, HTTP içeriğini bir akışa serileştirir. Aksi takdirde, bir NotSupportedExceptionoluşturur.
SerializeToStreamAsync(Stream, TransportContext)	HTTP içeriğini zaman uyumsuz bir işlem olarak akışa seri hale getirme.
SerializeToStreamAsync(Stream, TransportContext, CancellationToken)	HTTP içeriğini zaman uyumsuz bir işlem olarak akışa seri hale getirme.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TryComputeLength(Int64)	HTTP içeriğinin bayt cinsinden geçerli bir uzunluğu olup olmadığını belirler.

Uzantı Metotları

ReadFromJsonAsAsyncEnumerable<TValue>(HttpContent, JsonSerializerOptions, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir numaralandırılabilir işlemde içeriği JSON olarak seri durumdan çıkarmanın sonucunu veren değeri döndürür.
ReadFromJsonAsAsyncEnumerable<TValue>(HttpContent, JsonTypeInfo<TValue>, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir numaralandırılabilir işlemde içeriği JSON olarak seri durumdan çıkarmanın sonucunu veren değeri döndürür.
ReadFromJsonAsAsyncEnumerable<TValue>(HttpContent, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir numaralandırılabilir işlemde içeriği JSON olarak seri durumdan çıkarmanın sonucunu veren değeri döndürür.
ReadFromJsonAsync(HttpContent, Type, JsonSerializerOptions, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir işlemde içeriğin seri durumdan çıkarılmasından kaynaklanan değeri JSON olarak döndürür.
ReadFromJsonAsync(HttpContent, Type, JsonSerializerContext, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir işlemde içeriğin seri durumdan çıkarılmasından kaynaklanan değeri JSON olarak döndürür.
ReadFromJsonAsync(HttpContent, Type, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir işlemde içeriğin seri durumdan çıkarılmasından kaynaklanan değeri JSON olarak döndürür.
ReadFromJsonAsync<T>(HttpContent, JsonSerializerOptions, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir işlemde içeriğin seri durumdan çıkarılmasından kaynaklanan değeri JSON olarak döndürür.
ReadFromJsonAsync<T>(HttpContent, JsonTypeInfo<T>, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir işlemde içeriğin seri durumdan çıkarılmasından kaynaklanan değeri JSON olarak döndürür.
ReadFromJsonAsync<T>(HttpContent, CancellationToken)	HTTP içeriğini okur ve zaman uyumsuz bir işlemde içeriğin seri durumdan çıkarılmasından kaynaklanan değeri JSON olarak döndürür.