本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

HttpClientHandler 类

.NET Framework (current version)
 

HttpClient 使用的默认消息处理程序。

命名空间:   System.Net.Http
程序集:  System.Net.Http(位于 System.Net.Http.dll)

System.Object
  System.Net.Http.HttpMessageHandler
    System.Net.Http.HttpClientHandler
      System.Net.Http.WebRequestHandler

public class HttpClientHandler : HttpMessageHandler

名称说明
System_CAPS_pubmethodHttpClientHandler()

创建 HttpClientHandler 类的实例。

名称说明
System_CAPS_pubpropertyAllowAutoRedirect

获取或设置一个值,该值指示处理程序是否应跟随重定向响应。

System_CAPS_pubpropertyAutomaticDecompression

获取或设置处理程序用于自动解压缩 HTTP 内容响应的解压缩方法类型。

System_CAPS_pubpropertyClientCertificateOptions

获取或设置一个值,该值指示是否从证书存储自动挑选证书,或者是否允许调用方通过特定的客户端证书。

System_CAPS_pubpropertyCookieContainer

获取或设置用于通过处理程序存储服务器 Cookie 的 Cookie 容器。

System_CAPS_pubpropertyCredentials

获取或设置此处理程序使用的身份验证信息。

System_CAPS_pubpropertyMaxAutomaticRedirections

获取或设置处理程序遵循的重定向的最大数目。

System_CAPS_pubpropertyMaxRequestContentBufferSize

获取或设置处理程序使用的最大请求内容缓冲区大小。

System_CAPS_pubpropertyPreAuthenticate

获取或设置一个值,该值指示处理程序是否随请求发送授权标头。

System_CAPS_pubpropertyProxy

获取或设置处理程序使用的代理信息。

System_CAPS_pubpropertySupportsAutomaticDecompression

获取一个值,该值指示处理程序是否支持自动响应内容解压缩。

System_CAPS_pubpropertySupportsProxy

获取一个值,该值指示处理程序是否支持代理设置。

System_CAPS_pubpropertySupportsRedirectConfiguration

获取一个值,该值表示处理程序是否支持 AllowAutoRedirectMaxAutomaticRedirections 属性的配置设置。

System_CAPS_pubpropertyUseCookies

获取或设置一个值,该值指示处理程序是否使用 CookieContainer 属性来存储服务器 Cookie 并在发送请求时使用这些 Cookie。

System_CAPS_pubpropertyUseDefaultCredentials

获取或设置一个值,该值控制处理程序是否随请求一起发送默认凭据。

System_CAPS_pubpropertyUseProxy

获取或设置一个值,该值表示处理程序是否对请求使用代理。

名称说明
System_CAPS_pubmethodDispose()

释放非托管的资源并释放托管资源的使用由 HttpMessageHandler(继承自 HttpMessageHandler。)

System_CAPS_protmethodDispose(Boolean)

释放由 HttpClientHandler 使用的非托管资源,并可根据需要释放托管资源。(覆盖 HttpMessageHandler.Dispose(Boolean)。)

System_CAPS_pubmethodEquals(Object)

确定指定的对象是否等于当前对象。(继承自 Object。)

System_CAPS_protmethodFinalize()

在垃圾回收将某一对象回收前允许该对象尝试释放资源并执行其他清理操作。(继承自 Object。)

System_CAPS_pubmethodGetHashCode()

作为默认哈希函数。(继承自 Object。)

System_CAPS_pubmethodGetType()

获取当前实例的 Type(继承自 Object。)

System_CAPS_protmethodMemberwiseClone()

创建当前 Object 的浅表副本。(继承自 Object。)

System_CAPS_protmethodSendAsync(HttpRequestMessage, CancellationToken)

基于作为不会阻止的操作在 HttpRequestMessage 中提供的信息创建 HttpResponseMessage 的实例。(覆盖 HttpMessageHandler.SendAsync(HttpRequestMessage, CancellationToken)。)

System_CAPS_pubmethodToString()

返回表示当前对象的字符串。(继承自 Object。)

The T:System.Net.Http.HttpClientHandler class and classes derived from it enable developers to configure a variety of options ranging from proxies to authentication.

 static async void Main()
{
    // Create an HttpClientHandler object and set to use default credentials
    HttpClientHandler handler = new HttpClientHandler();
    handler.UseDefaultCredentials = true;

    // Create an HttpClient object
    HttpClient client = new HttpClient(handler);

    // Call asynchronous network methods in a try/catch block to handle exceptions
    try	
    {
       HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");

       response.EnsureSuccessStatusCode();

       string responseBody = await response.Content.ReadAsStringAsync();
       Console.WriteLine(responseBody);
     }  
     catch(HttpRequestException e)
     {
        Console.WriteLine("\nException Caught!");	
        Console.WriteLine("Message :{0} ",e.Message);
     }

     // Need to call dispose on the HttpClient and HttpClientHandler objects 
     // when done using them, so the app doesn't leak resources
     handler.Dispose(true);
     client.Dispose(true);
 }

通用 Windows 平台
自 8 起可用
.NET Framework
自 4.5 起可用
可移植类库
可移植 .NET 平台 中受支持
Windows Phone
自 8.1 起可用

此类型的所有公共静态(Visual Basic 中的 已共享 在 Visual Basic 中)成员都是线程安全的。不保证所有实例成员都是线程安全的。

返回页首
显示: