HttpClient.GetAsync Metod

Definition

Namnområde:: System.Net.Http

Sammansättning:: System.Net.Http.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skicka en GET-begäran till den angivna URI:n som en asynkron åtgärd.

Överlagringar

Name	Description
GetAsync(String)	Skicka en GET-begäran till den angivna URI:n som en asynkron åtgärd.
GetAsync(Uri)	Skicka en GET-begäran till den angivna URI:n som en asynkron åtgärd.
GetAsync(String, HttpCompletionOption)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ som en asynkron åtgärd.
GetAsync(String, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.
GetAsync(Uri, HttpCompletionOption)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ som en asynkron åtgärd.
GetAsync(Uri, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.
GetAsync(String, HttpCompletionOption, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ och en annulleringstoken som en asynkron åtgärd.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ och en annulleringstoken som en asynkron åtgärd.

Kommentarer

Åtgärden blockeras inte.

GetAsync(String)

Skicka en GET-begäran till den angivna URI:n som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri);

member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)

Parametrar

requestUri: String

Den URI som begäran skickas till.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

Begäran misslyckades på grund av ett problem med att få ett giltigt HTTP-svar, till exempel nätverksanslutningsfel, DNS-fel, verifieringsfel för servercertifikat eller ogiltigt serversvar. På .NET 8 och senare versioner anges orsaken av HttpRequestError

-eller-

endast .NET Framework: tidsgränsen för begäran har överskrids.

OperationCanceledException

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

UriFormatException

Den angivna begärande-URI:n är inte giltig relativ eller absolut URI.

Kommentarer

Den här åtgärden blockeras inte. Det returnerade objektet slutförs Task<TResult> när hela svaret (inklusive innehåll) har lästs. Beteendet är detsamma som om ResponseContentRead det uttryckligen har angetts.

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

GetAsync(Uri)

Skicka en GET-begäran till den angivna URI:n som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri);

member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

Parametrar

requestUri: Uri

Den URI som begäran skickas till.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

-eller-

endast .NET Framework: tidsgränsen för begäran har överskrids.

OperationCanceledException

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

Kommentarer

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

GetAsync(String, HttpCompletionOption)

Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parametrar

requestUri: String

Den URI som begäran skickas till.

completionOption: HttpCompletionOption

Ett http-slutförandealternativvärde som anger när åtgärden ska betraktas som slutförd.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

Begäran misslyckades på grund av ett underliggande problem som nätverksanslutning, DNS-fel, verifiering av servercertifikat eller tidsgräns.

OperationCanceledException

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

UriFormatException

Den angivna begärande-URI:n är inte giltig relativ eller absolut URI.

Kommentarer

Den här åtgärden blockeras inte. Det returnerade objektet slutförs Task<TResult> baserat på parametern completionOption när delen eller hela svaret (inklusive innehåll) har lästs.

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

GetAsync(String, CancellationToken)

Skicka en GET-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametrar

requestUri: String

Den URI som begäran skickas till.

cancellationToken: CancellationToken

En annulleringstoken som kan användas av andra objekt eller trådar för att få meddelande om annullering.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

-eller-

endast .NET Framework: tidsgränsen för begäran har överskrids.

UriFormatException

Den angivna begärande-URI:n är inte giltig relativ eller absolut URI.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

-eller-

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

Kommentarer

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

GetAsync(Uri, HttpCompletionOption)

Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parametrar

requestUri: Uri

Den URI som begäran skickas till.

completionOption: HttpCompletionOption

Ett http-slutförandealternativvärde som anger när åtgärden ska betraktas som slutförd.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

-eller-

endast .NET Framework: tidsgränsen för begäran har överskrids.

OperationCanceledException

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

Kommentarer

Den här åtgärden blockeras inte. Det returnerade objektet slutförs Task<TResult> baserat på parametern completionOption när delen eller hela svaret (inklusive innehåll) har lästs.

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

GetAsync(Uri, CancellationToken)

Skicka en GET-begäran till den angivna URI:n med en annulleringstoken som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametrar

requestUri: Uri

Den URI som begäran skickas till.

cancellationToken: CancellationToken

En annulleringstoken som kan användas av andra objekt eller trådar för att få meddelande om annullering.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

Begäran misslyckades på grund av ett problem med att hämta ett HTTP-svar, till exempel nätverksanslutning, DNS-fel eller verifiering av servercertifikat. På .NET 8 och senare versioner anges orsaken av HttpRequestError

-eller-

endast .NET Framework: tidsgränsen för begäran har överskrids.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

-eller-

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

Kommentarer

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

GetAsync(String, HttpCompletionOption, CancellationToken)

Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ och en annulleringstoken som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametrar

requestUri: String

Den URI som begäran skickas till.

completionOption: HttpCompletionOption

Ett http-slutförandealternativvärde som anger när åtgärden ska betraktas som slutförd.

cancellationToken: CancellationToken

En annulleringstoken som kan användas av andra objekt eller trådar för att få meddelande om annullering.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

-eller-

endast .NET Framework: tidsgränsen för begäran har överskrids.

UriFormatException

Den angivna begärande-URI:n är inte giltig relativ eller absolut URI.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

-eller-

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

Kommentarer

Den här åtgärden blockeras inte. Det returnerade objektet slutförs Task<TResult> baserat på parametern completionOption när delen eller hela svaret (inklusive innehåll) har lästs.

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Skicka en GET-begäran till den angivna URI:n med ett HTTP-slutförandealternativ och en annulleringstoken som en asynkron åtgärd.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametrar

requestUri: Uri

Den URI som begäran skickas till.

completionOption: HttpCompletionOption

Ett http-slutförandealternativvärde som anger när åtgärden ska betraktas som slutförd.

cancellationToken: CancellationToken

En annulleringstoken som kan användas av andra objekt eller trådar för att få meddelande om annullering.

Returer

Task<HttpResponseMessage>

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

requestUri är inte en absolut URI och BaseAddress har inte angetts.

HttpRequestException

-eller-

endast .NET Framework: tidsgränsen för begäran har överskrids.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

-eller-

.NET Core och .NET endast 5 och senare: Begäran misslyckades på grund av tidsgränsen.

Kommentarer

Den här åtgärden blockeras inte. Det returnerade objektet slutförs Task<TResult> baserat på parametern completionOption när delen eller hela svaret (inklusive innehåll) har lästs.

Note

Vid timeout genereras olika undantag på olika .NET implementeringar.

HttpRequestException genereras på alla tillämpliga .NET Framework-versioner.
OperationCanceledException utan något inre undantag genereras på alla tillämpliga .NET Core-versioner.
OperationCanceledException som kapslar en TimeoutException genereras på .NET 5 och senare versioner.

Gäller för

Feedback

Var den här sidan till hjälp?