HttpClient Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Udostępnia klasę do wysyłania żądań HTTP i odbierania odpowiedzi HTTP z zasobu zidentyfikowanego przez identyfikator URI.
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
- Dziedziczenie
Przykłady
// 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
Uwagi
Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla klienta HttpClient.
Konstruktory
HttpClient() |
Inicjuje HttpClient nowe wystąpienie klasy przy użyciu HttpClientHandler klasy, która jest usuwana po usunięciu tego wystąpienia. |
HttpClient(HttpMessageHandler) |
Inicjuje HttpClient nowe wystąpienie klasy za pomocą określonej procedury obsługi. Procedura obsługi jest usuwana po usunięciu tego wystąpienia. |
HttpClient(HttpMessageHandler, Boolean) |
Inicjuje HttpClient nowe wystąpienie klasy z podaną procedurą obsługi i określa, czy ta procedura obsługi powinna zostać usunięta po usunięciu tego wystąpienia. |
Właściwości
BaseAddress |
Pobiera lub ustawia podstawowy adres identyfikatora URI zasobu internetowego używanego podczas wysyłania żądań. |
DefaultProxy |
Pobiera lub ustawia globalny serwer proxy HTTP. |
DefaultRequestHeaders |
Pobiera nagłówki, które powinny być wysyłane z każdym żądaniem. |
DefaultRequestVersion |
Pobiera lub ustawia domyślną wersję HTTP używaną w kolejnych żądaniach wysyłanych przez to HttpClient wystąpienie. |
DefaultVersionPolicy |
Pobiera lub ustawia domyślne zasady wersji dla niejawnie utworzonych żądań w metodach wygody, na przykład GetAsync(String) i PostAsync(String, HttpContent). |
MaxResponseContentBufferSize |
Pobiera lub ustawia maksymalną liczbę bajtów do buforu podczas odczytywania zawartości odpowiedzi. |
Timeout |
Pobiera lub ustawia przedział czasu oczekiwania przed upływem limitu czasu żądania. |
Metody
CancelPendingRequests() |
Anuluj wszystkie oczekujące żądania w tym wystąpieniu. |
DeleteAsync(String) |
Wyślij żądanie USUŃ do określonego identyfikatora Uri jako operację asynchroniczną. |
DeleteAsync(String, CancellationToken) |
Wyślij żądanie DELETE do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną. |
DeleteAsync(Uri) |
Wyślij żądanie USUŃ do określonego identyfikatora Uri jako operację asynchroniczną. |
DeleteAsync(Uri, CancellationToken) |
Wyślij żądanie DELETE do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną. |
Dispose() |
Zwalnia niezarządzane zasoby i usuwa zarządzane zasoby używane przez program HttpMessageInvoker. (Odziedziczone po HttpMessageInvoker) |
Dispose(Boolean) |
Zwalnia niezarządzane zasoby używane przez HttpClient program i opcjonalnie usuwa zasoby zarządzane. |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetAsync(String) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri jako operację asynchroniczną. |
GetAsync(String, CancellationToken) |
Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną. |
GetAsync(String, HttpCompletionOption) |
Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operacją asynchroniczną. |
GetAsync(String, HttpCompletionOption, CancellationToken) |
Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną. |
GetAsync(Uri) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri jako operację asynchroniczną. |
GetAsync(Uri, CancellationToken) |
Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną. |
GetAsync(Uri, HttpCompletionOption) |
Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operacją asynchroniczną. |
GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną. |
GetByteArrayAsync(String) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej. |
GetByteArrayAsync(String, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej. |
GetByteArrayAsync(Uri) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej. |
GetByteArrayAsync(Uri, CancellationToken) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej. |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetStreamAsync(String) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej. |
GetStreamAsync(String, CancellationToken) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej. |
GetStreamAsync(Uri) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej. |
GetStreamAsync(Uri, CancellationToken) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej. |
GetStringAsync(String) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
GetStringAsync(String, CancellationToken) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
GetStringAsync(Uri) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
GetStringAsync(Uri, CancellationToken) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
PatchAsync(String, HttpContent) |
Wysyła żądanie PATCH do identyfikatora URI wyznaczonego jako ciąg jako operację asynchroniczną. |
PatchAsync(String, HttpContent, CancellationToken) |
Wysyła żądanie PATCH z tokenem anulowania do identyfikatora URI reprezentowanego jako ciąg jako operacja asynchroniczna. |
PatchAsync(Uri, HttpContent) |
Wysyła żądanie PATCH jako operację asynchroniczną. |
PatchAsync(Uri, HttpContent, CancellationToken) |
Wysyła żądanie PATCH z tokenem anulowania jako operacją asynchroniczną. |
PostAsync(String, HttpContent) |
Wyślij żądanie WYŚLIJ do określonego identyfikatora Uri jako operację asynchroniczną. |
PostAsync(String, HttpContent, CancellationToken) |
Wyślij żądanie POST z tokenem anulowania jako operacją asynchroniczną. |
PostAsync(Uri, HttpContent) |
Wyślij żądanie WYŚLIJ do określonego identyfikatora Uri jako operację asynchroniczną. |
PostAsync(Uri, HttpContent, CancellationToken) |
Wyślij żądanie POST z tokenem anulowania jako operacją asynchroniczną. |
PutAsync(String, HttpContent) |
Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną. |
PutAsync(String, HttpContent, CancellationToken) |
Wyślij żądanie PUT z tokenem anulowania jako operacją asynchroniczną. |
PutAsync(Uri, HttpContent) |
Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną. |
PutAsync(Uri, HttpContent, CancellationToken) |
Wyślij żądanie PUT z tokenem anulowania jako operacją asynchroniczną. |
Send(HttpRequestMessage) |
Wysyła żądanie HTTP z określonym żądaniem. |
Send(HttpRequestMessage, CancellationToken) |
Wysyła żądanie HTTP z określonym żądaniem i tokenem anulowania. |
Send(HttpRequestMessage, CancellationToken) |
Wysyła żądanie HTTP z określonym żądaniem i tokenem anulowania. (Odziedziczone po HttpMessageInvoker) |
Send(HttpRequestMessage, HttpCompletionOption) |
Wysyła żądanie HTTP. |
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Wysyła żądanie HTTP z określonym żądaniem, opcją ukończenia i tokenem anulowania. |
SendAsync(HttpRequestMessage) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
SendAsync(HttpRequestMessage, CancellationToken) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
SendAsync(HttpRequestMessage, HttpCompletionOption) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Metody rozszerzania
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync(HttpClient, String, Type, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync(HttpClient, Uri, Type, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync<TValue>(HttpClient, String, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
DeleteFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken) |
Wysyła żądanie DELETE do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, String, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
|
GetFromJsonAsAsyncEnumerable<TValue>(HttpClient, Uri, CancellationToken) |
|
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync(HttpClient, String, Type, JsonSerializerContext, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync(HttpClient, String, Type, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync(HttpClient, Uri, Type, JsonSerializerContext, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync(HttpClient, Uri, Type, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync<TValue>(HttpClient, String, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync<TValue>(HttpClient, String, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync<TValue>(HttpClient, String, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync<TValue>(HttpClient, Uri, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
GetFromJsonAsync<TValue>(HttpClient, Uri, CancellationToken) |
Wysyła żądanie GET do określonego identyfikatora URI i zwraca wartość, która wynika z deserializacji treści odpowiedzi jako kodu JSON w operacji asynchronicznej. |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego |
PatchAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego |
PatchAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Wysyła żądanie PATCH do określonego identyfikatora URI zawierającego |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie POST do określonego identyfikatora URI zawierającego |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie POST do określonego identyfikatora URI zawierającego |
PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Wysyła żądanie POST do określonego identyfikatora URI zawierającego |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Wysyła żądanie POST do określonego identyfikatora URI zawierającego |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Wysyła żądanie POST do określonego identyfikatora URI zawierającego |
PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Wysyła żądanie POST do określonego identyfikatora URI zawierającego |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
Wyślij żądanie PUT do określonego identyfikatora URI zawierającego |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Wyślij żądanie PUT do określonego identyfikatora URI zawierającego |
PutAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
Wyślij żądanie PUT do określonego identyfikatora URI zawierającego |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
Wyślij żądanie PUT do określonego identyfikatora URI zawierającego |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Wyślij żądanie PUT do określonego identyfikatora URI zawierającego |
PutAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
Wyślij żądanie PUT do określonego identyfikatora URI zawierającego |