6.2内置内容处理器

创建于 2026 年 8 月 17 日约 7 分钟读完
  • StringContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 StringContentProcessor 来构建 StringContent 实例:

  • 原始请求内容为 StringContentJsonContent
  • 内容类型包括 application/jsonapplication/json-patch+jsonapplication/xmlapplication/xml-patch+xmltext/xmltext/htmltext/plain 以及 application/soap+xml,且即使这些类型后附加有 charset 字符集(例如 application/json; charset=utf-8),依然适用。

  • StreamContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 StreamContentProcessor 来构建 StreamContent 实例:

  • 原始请求内容为 StreamContentStream

  • ByteArrayContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 ByteArrayContentProcessor 来构建 ByteArrayContent 实例:

  • 原始请求内容为 ByteArrayContentbyte[],且不为 FormUrlEncodedContentStringContent

  • FormUrlEncodedContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 FormUrlEncodedContentProcessor 来构建 FormUrlEncodedContent 实例:

  • 原始请求内容为 FormUrlEncodedContentURL 编码格式的字符串。
  • 内容类型为 application/x-www-form-urlencoded,且即使类型后附加有 charset 字符集(例如 application/x-www-form-urlencoded; charset=utf-8),依然适用。

  • StringContentForFormUrlEncodedContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 StringContentForFormUrlEncodedContentProcessor 来构建内容类型为 application/x-www-form-urlencodedStringContent 实例:

  • 原始请求内容为 FormUrlEncodedContentURL 编码格式的字符串。
  • 内容类型为 application/x-www-form-urlencoded,且即使类型后附加有 charset 字符集(例如 application/x-www-form-urlencoded; charset=utf-8),依然适用。
  • useStringContent 参数或 UseStringContent 属性 为 true

StringContentForFormUrlEncodedContentProcessor 派生自 FormUrlEncodedContentProcessor


  • ReadOnlyMemoryContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 ReadOnlyMemoryContentProcessor 来构建 ReadOnlyMemoryContent 实例:

  • 原始请求内容为 ReadOnlyMemoryContentReadOnlyMemory<byte>

  • MultipartFormDataContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 MultipartFormDataContentProcessor 来构建 MultipartFormDataContent 实例:

  • 原始请求内容为 MultipartFormDataContent
  • 内容类型为 multipart/form-data,且即使类型后附加有 charset 字符集(例如 multipart/form-data; charset=utf-8),依然适用。

  • MessagePackContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 MessagePackContentProcessor 来构建 ByteArrayContent 实例:

  • 内容类型为 application/msgpack,且即使类型后附加有 charset 字符集(例如 application/msgpack; charset=utf-8),依然适用。

  • JsonLinesContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 JsonLinesContentProcessor 来构建 StringContent 实例:

  • 内容类型包括 application/x-ndjsonapplication/x-jsonlinesapplication/jsonlines 以及 application/jsonl,且即使类型后附加有 charset 字符集(例如 application/x-ndjson; charset=utf-8),依然适用。

  • FileInfoContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 FileInfoContentProcessor 来构建 StreamContent 实例:

  • 原始请求内容为 FileInfo

  • FormFileContentProcessor 内容处理器

当原始请求内容满足以下条件时,将使用 FormFileContentProcessor 来构建 StreamContent 实例:

  • 原始请求内容为 IFormFile