6.8内置内容转换器

创建于 2026 年 8 月 17 日约 4 分钟读完
  • StringContentConverter 内容转换器

当目标接收类型为字符串时,将使用 StringContentConverter 来将 HttpResponseMessage 对象转换为字符串。该转换过程内部调用了 HttpResponseMessage.Content 提供的 ReadAsStringAsync 方法来实现。


  • StreamContentConverter 内容转换器

当目标接收类型为 Stream 时,将使用 StreamContentConverter 来将 HttpResponseMessage 对象转换为 Stream。该转换过程内部调用了 HttpResponseMessage.Content 提供的 ReadAsStreamAsync 方法来实现。


  • ByteArrayContentConverter 内容转换器

当目标接收类型为字节数组时,将使用 ByteArrayContentConverter 来将 HttpResponseMessage 对象转换为字节数组。该转换过程内部调用了 HttpResponseMessage.Content 提供的 ReadAsByteArrayAsync 方法来实现。


  • HttpResponseMessageConverter 内容转换器

当目标接收类型为 HttpResponseMessage 时,将使用 HttpResponseMessageConverter 来将 HttpResponseMessage 对象直接返回。


  • VoidContentConverter 内容转换器

当目标接收类型为 voidVoidContent 时,将使用 VoidContentConverter 来返回空值(无返回值)。


  • IActionResultContentConverter 内容转换器

当目标接收类型为 IActionResult 时,将使用 IActionResultContentConverter 来将 HttpResponseMessage 对象转换为 IActionResultContentConverter


  • AsyncEnumerableContentConverter<T> 内容转换器

当目标接收类型为 IAsyncEnumerable<T> 时,将使用 AsyncEnumerableContentConverter<T> 来将 HttpResponseMessage 对象转换为 IAsyncEnumerable<T>。该转换过程内部调用了 HttpResponseMessage.Content 提供的 ReadFromJsonAsAsyncEnumerable 方法来实现。


  • HttpRemoteResult<T> 内容转换器

当目标接收类型为 HttpRemoteResult<T> 时,将使用 HttpRemoteResultContentConverter<T> 来将 HttpResponseMessage 对象转换为 HttpRemoteResult<T>。该转换过程内部调用了 IHttpContentConverterFactory 提供的 ReadAsync 方法来实现。


  • ObjectContentConverter 内容转换器

当目标接收类型不为特定类型,例如自定义类型、基本数据类型(如 intbool 等)在内的多种类型,将使用 ObjectContentConverter 来将 HttpResponseMessage 对象转换为目标接收类型。该转换过程内部调用了 HttpResponseMessage.Content 提供的 ReadFromJsonAsync 方法来实现。