HttpClient クラス

定義

URI によって識別されるリソースから HTTP 要求を送信し、HTTP 応答を受信するためのクラスを提供します。

public ref class HttpClient : System::Net::Http::HttpMessageInvoker
public class HttpClient : System.Net.Http.HttpMessageInvoker
type HttpClient = class
    inherit HttpMessageInvoker
Public Class HttpClient
Inherits HttpMessageInvoker
継承

// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
static readonly HttpClient client = new HttpClient();

static async Task Main()
{
    // Call asynchronous network methods in a try/catch block to handle exceptions.
    try
    {
        using HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
        response.EnsureSuccessStatusCode();
        string responseBody = await response.Content.ReadAsStringAsync();
        // Above three lines can be replaced with new helper method below
        // string responseBody = await client.GetStringAsync(uri);

        Console.WriteLine(responseBody);
    }
    catch (HttpRequestException e)
    {
        Console.WriteLine("\nException Caught!");
        Console.WriteLine("Message :{0} ", e.Message);
    }
}
open System.Net.Http

// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
let client = new HttpClient()

let main =
    task {
        // Call asynchronous network methods in a try/catch block to handle exceptions.
        try
            use! response = client.GetAsync "http://www.contoso.com/"
            response.EnsureSuccessStatusCode() |> ignore
            let! responseBody = response.Content.ReadAsStringAsync()
            // Above three lines can be replaced with new helper method below
            // let! responseBody = client.GetStringAsync uri

            printfn $"{responseBody}"
        with
        | :? HttpRequestException as e ->
            printfn "\nException Caught!"
            printfn $"Message :{e.Message} "
    }

main.Wait()
' HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
Shared ReadOnly client As HttpClient = New HttpClient()

Private Shared Async Function Main() As Task
    ' Call asynchronous network methods in a try/catch block to handle exceptions.
    Try
        Using response As HttpResponseMessage = Await client.GetAsync("http://www.contoso.com/")
            response.EnsureSuccessStatusCode()
            Dim responseBody As String = Await response.Content.ReadAsStringAsync()
            ' Above three lines can be replaced with new helper method below
            ' Dim responseBody As String = Await client.GetStringAsync(uri)

            Console.WriteLine(responseBody)
        End Using
    Catch e As HttpRequestException
        Console.WriteLine(Environment.NewLine & "Exception Caught!")
        Console.WriteLine("Message :{0} ", e.Message)
    End Try
End Function

注釈

この API の詳細については、「 HttpClient の補足 API 解説」を参照してください。

コンストラクター

HttpClient()

このインスタンスが破棄されたときに破棄される HttpClientHandler を使用して、HttpClient クラスの新しいインスタンスを初期化します。

HttpClient(HttpMessageHandler)

指定したハンドラーを使用して、HttpClient クラスの新しいインスタンスを初期化します。 このインスタンスが破棄されたときに、ハンドラーは破棄されます。

HttpClient(HttpMessageHandler, Boolean)

提供されたハンドラーを使用して、HttpClient クラスの新しいインスタンスを初期化し、このインスタンスが破棄されるときにそのハンドラーを破棄するかどうかを指定します。

プロパティ

BaseAddress

要求を送信するときに使用する、インターネット リソースの Uniform Resource Identifier (URI) のベース アドレスを取得または設定します。

DefaultProxy

グローバル HTTP プロキシを取得または設定します。

DefaultRequestHeaders

各要求と一緒に送信する必要があるヘッダーを取得します。

DefaultRequestVersion

この HttpClient インスタンスによって行われる後続の要求で使用される、既定の HTTP バージョンを取得または設定します。

DefaultVersionPolicy

GetAsync(String)PostAsync(String, HttpContent) などの便利なメソッドで暗黙的に作成される要求の既定のバージョン ポリシーを取得または設定します。

MaxResponseContentBufferSize

応答の内容を読み取るときにバッファーに格納できる最大バイト数を取得または設定します。

Timeout

要求がタイムアウトするまで待機する期間を取得または設定します。

メソッド

CancelPendingRequests()

このインスタンスの保留中の要求をすべてキャンセルします。

DeleteAsync(String)

指定された URI に DELETE 要求を非同期操作として送信します。

DeleteAsync(String, CancellationToken)

非同期操作としてキャンセル トークンを使用して削除要求を指定された Uri に送信します。

DeleteAsync(Uri)

指定された URI に DELETE 要求を非同期操作として送信します。

DeleteAsync(Uri, CancellationToken)

非同期操作としてキャンセル トークンを使用して削除要求を指定された Uri に送信します。

Dispose()

HttpMessageInvoker が使用しているアンマネージド リソースを解放し、マネージド リソースを破棄します。

(継承元 HttpMessageInvoker)
Dispose(Boolean)

HttpClient が使用しているアンマネージド リソースを解放します。オプションとして、マネージド リソースを破棄することもできます。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetAsync(String)

指定された URI に GET 要求を非同期操作として送信します。

GetAsync(String, CancellationToken)

非同期操作としてキャンセル トークンを使用して GET 要求を指定された Uri に送信します。

GetAsync(String, HttpCompletionOption)

非同期操作としてHTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

GetAsync(String, HttpCompletionOption, CancellationToken)

非同期操作としてキャンセル トークンおよび HTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

GetAsync(Uri)

指定された URI に GET 要求を非同期操作として送信します。

GetAsync(Uri, CancellationToken)

非同期操作としてキャンセル トークンを使用して GET 要求を指定された Uri に送信します。

GetAsync(Uri, HttpCompletionOption)

非同期操作としてHTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

GetAsync(Uri, HttpCompletionOption, CancellationToken)

非同期操作としてキャンセル トークンおよび HTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

GetByteArrayAsync(String)

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

GetByteArrayAsync(String, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

GetByteArrayAsync(Uri)

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

GetByteArrayAsync(Uri, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetStreamAsync(String)

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

GetStreamAsync(String, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

GetStreamAsync(Uri)

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

GetStreamAsync(Uri, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体をストリームとして返します。

GetStringAsync(String)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

GetStringAsync(String, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

GetStringAsync(Uri)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

GetStringAsync(Uri, CancellationToken)

指定 URI に GET 要求を送信し、非同期操作で応答本体を文字列として返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
PatchAsync(String, HttpContent)

文字列として指定されている URI に PATCH 要求を非同期操作として送信します。

PatchAsync(String, HttpContent, CancellationToken)

文字列として表現されている URI に PATCH 要求をキャンセル トークン付きで非同期操作として送信します。

PatchAsync(Uri, HttpContent)

非同期操作として PATCH 要求を送信します。

PatchAsync(Uri, HttpContent, CancellationToken)

PATCH 要求をキャンセル トークンと共に非同期操作として送信します。

PostAsync(String, HttpContent)

指定された URI に POST 要求を非同期操作として送信します。

PostAsync(String, HttpContent, CancellationToken)

POST 要求をキャンセル トークンとともに非同期操作として送信します。

PostAsync(Uri, HttpContent)

指定された URI に POST 要求を非同期操作として送信します。

PostAsync(Uri, HttpContent, CancellationToken)

POST 要求をキャンセル トークンとともに非同期操作として送信します。

PutAsync(String, HttpContent)

指定された URI に PUT 要求を非同期操作として送信します。

PutAsync(String, HttpContent, CancellationToken)

PUT 要求をとキャンセル トークンと共に非同期操作として送信します。

PutAsync(Uri, HttpContent)

指定された URI に PUT 要求を非同期操作として送信します。

PutAsync(Uri, HttpContent, CancellationToken)

PUT 要求をとキャンセル トークンと共に非同期操作として送信します。

Send(HttpRequestMessage)

指定した要求を使用して HTTP 要求を送信します。

Send(HttpRequestMessage, CancellationToken)

指定した要求とキャンセル トークンを使用して HTTP 要求を送信します。

Send(HttpRequestMessage, CancellationToken)

指定した要求とキャンセル トークンを使用して HTTP 要求を送信します。

(継承元 HttpMessageInvoker)
Send(HttpRequestMessage, HttpCompletionOption)

HTTP 要求を送信します。

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

指定した要求、完了オプション、およびキャンセル トークンを使用して HTTP 要求を送信します。

SendAsync(HttpRequestMessage)

非同期操作として HTTP 要求を送信します。

SendAsync(HttpRequestMessage, CancellationToken)

非同期操作として HTTP 要求を送信します。

SendAsync(HttpRequestMessage, HttpCompletionOption)

非同期操作として HTTP 要求を送信します。

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

非同期操作として HTTP 要求を送信します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

拡張メソッド

DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)

指定した Uri に DELETE 要求を送信し、非同期操作で応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)

HTTP GET指定した requestUri に要求を送信し、非同期列挙可能な操作で応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)

HTTP GET指定した requestUri に要求を送信し、非同期列挙可能な操作で応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken)

HTTP GET指定した requestUri に要求を送信し、非同期列挙可能な操作で応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)

HTTP GET指定した requestUri に要求を送信し、非同期列挙可能な操作で応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)

HTTP GET指定した requestUri に要求を送信し、非同期列挙可能な操作で応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken)

HTTP GET指定した requestUri に要求を送信し、非同期列挙可能な操作で応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync(HttpClient, String, Type, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken)

非同期操作で指定された URI に GET 要求を送信し、応答本文を JSON として逆シリアル化した結果の値を返します。

PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

要求本文で JSON としてシリアル化された を value 含む指定された URI に PATCH 要求を送信します。

PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

要求本文で JSON としてシリアル化された を value 含む指定された URI に PATCH 要求を送信します。

PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

要求本文で JSON としてシリアル化された を value 含む指定された URI に PATCH 要求を送信します。

PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

要求本文で JSON としてシリアル化された を value 含む指定された URI に PATCH 要求を送信します。

PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

要求本文で JSON としてシリアル化された を value 含む指定された URI に PATCH 要求を送信します。

PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

要求本文で JSON としてシリアル化された を value 含む指定された URI に PATCH 要求を送信します。

PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる POST 要求を、指定された URI に送信します。

PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる POST 要求を、指定された URI に送信します。

PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる POST 要求を、指定された URI に送信します。

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる POST 要求を、指定された URI に送信します。

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる POST 要求を、指定された URI に送信します。

PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる POST 要求を、指定された URI に送信します。

PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる PUT 要求を、指定された URI に送信します。

PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる PUT 要求を、指定された URI に送信します。

PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる PUT 要求を、指定された URI に送信します。

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる PUT 要求を、指定された URI に送信します。

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる PUT 要求を、指定された URI に送信します。

PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken)

要求本文に JSON としてシリアル化された value が含まれる PUT 要求を、指定された URI に送信します。

適用対象

こちらもご覧ください