HttpClient.GetAsync Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
GET kérés küldése a megadott URI-nak aszinkron műveletként.
Túlterhelések
| Name | Description |
|---|---|
| GetAsync(String) |
GET kérés küldése a megadott URI-nak aszinkron műveletként. |
| GetAsync(Uri) |
GET kérés küldése a megadott URI-nak aszinkron műveletként. |
| GetAsync(String, HttpCompletionOption) |
GET kérés küldése a megadott URI-nak http-befejezési lehetőséggel aszinkron műveletként. |
| GetAsync(String, CancellationToken) |
Get kérés küldése a megadott URI-nak egy lemondási jogkivonattal aszinkron műveletként. |
| GetAsync(Uri, HttpCompletionOption) |
GET kérés küldése a megadott URI-nak http-befejezési lehetőséggel aszinkron műveletként. |
| GetAsync(Uri, CancellationToken) |
Get kérés küldése a megadott URI-nak egy lemondási jogkivonattal aszinkron műveletként. |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
GET kérés küldése a megadott URI-nak EGY HTTP-befejezési lehetőséggel és egy lemondási jogkivonattal aszinkron műveletként. |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
GET kérés küldése a megadott URI-nak EGY HTTP-befejezési lehetőséggel és egy lemondási jogkivonattal aszinkron műveletként. |
Megjegyzések
A művelet nem lesz blokkolva.
GetAsync(String)
GET kérés küldése a megadott URI-nak aszinkron műveletként.
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)Paraméterek
- requestUri
- String
A kérelem URI-ja.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError
-vagy-
csak .NET keretrendszer: a kérés túllépte az időkorlátot.
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
A megadott kérelem URI-ja nem érvényes relatív vagy abszolút URI.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes válasz (beleértve a tartalmat) elolvasása után befejeződik. A viselkedés ugyanaz, mint ha ResponseContentRead explicit módon lett megadva.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.
A következőre érvényes:
GetAsync(Uri)
GET kérés küldése a megadott URI-nak aszinkron műveletként.
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)Paraméterek
- requestUri
- Uri
A kérelem URI-ja.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError
-vagy-
csak .NET keretrendszer: a kérés túllépte az időkorlátot.
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes válasz (beleértve a tartalmat) elolvasása után befejeződik. A viselkedés ugyanaz, mint ha ResponseContentRead explicit módon lett megadva.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.
A következőre érvényes:
GetAsync(String, HttpCompletionOption)
GET kérés küldése a megadott URI-nak http-befejezési lehetőséggel aszinkron műveletként.
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)Paraméterek
- requestUri
- String
A kérelem URI-ja.
- completionOption
- HttpCompletionOption
EGY HTTP-befejezési beállítás értéke, amely jelzi, hogy a műveletet mikor kell befejezettnek tekinteni.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
A kérés egy mögöttes probléma, például hálózati kapcsolat, DNS-hiba, kiszolgálótanúsítvány érvényesítése vagy időtúllépés miatt meghiúsult.
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
A megadott kérelem URI-ja nem érvényes relatív vagy abszolút URI.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a completionOption paraméter alapján fejeződik be a válasz egy részének vagy egészének (beleértve a tartalmat is) olvasása után.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.
A következőre érvényes:
GetAsync(String, CancellationToken)
Get kérés küldése a megadott URI-nak egy lemondási jogkivonattal aszinkron műveletként.
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)Paraméterek
- requestUri
- String
A kérelem URI-ja.
- cancellationToken
- CancellationToken
Lemondási jogkivonat, amelyet más objektumok vagy szálak használhatnak a lemondásról szóló értesítés fogadásához.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError
-vagy-
csak .NET keretrendszer: a kérés túllépte az időkorlátot.
A megadott kérelem URI-ja nem érvényes relatív vagy abszolút URI.
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
-vagy-
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes válasz (beleértve a tartalmat) elolvasása után befejeződik. A viselkedés ugyanaz, mint ha ResponseContentRead explicit módon lett megadva.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.
A következőre érvényes:
GetAsync(Uri, HttpCompletionOption)
GET kérés küldése a megadott URI-nak http-befejezési lehetőséggel aszinkron műveletként.
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)Paraméterek
- requestUri
- Uri
A kérelem URI-ja.
- completionOption
- HttpCompletionOption
EGY HTTP-befejezési beállítás értéke, amely jelzi, hogy a műveletet mikor kell befejezettnek tekinteni.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError
-vagy-
csak .NET keretrendszer: a kérés túllépte az időkorlátot.
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a completionOption paraméter alapján fejeződik be a válasz egy részének vagy egészének (beleértve a tartalmat is) olvasása után.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.
A következőre érvényes:
GetAsync(Uri, CancellationToken)
Get kérés küldése a megadott URI-nak egy lemondási jogkivonattal aszinkron műveletként.
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)Paraméterek
- requestUri
- Uri
A kérelem URI-ja.
- cancellationToken
- CancellationToken
Lemondási jogkivonat, amelyet más objektumok vagy szálak használhatnak a lemondásról szóló értesítés fogadásához.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
TA kérés meghiúsult, mert http-választ kapott, például hálózati kapcsolatot, DNS-hibát vagy kiszolgálótanúsítvány-ellenőrzést kapott. A 8-.NET és újabb verziókban ennek okát HttpRequestError
-vagy-
csak .NET keretrendszer: a kérés túllépte az időkorlátot.
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
-vagy-
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a teljes válasz (beleértve a tartalmat) elolvasása után befejeződik. A viselkedés ugyanaz, mint ha ResponseContentRead explicit módon lett megadva.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.
A következőre érvényes:
GetAsync(String, HttpCompletionOption, CancellationToken)
GET kérés küldése a megadott URI-nak EGY HTTP-befejezési lehetőséggel és egy lemondási jogkivonattal aszinkron műveletként.
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)Paraméterek
- requestUri
- String
A kérelem URI-ja.
- completionOption
- HttpCompletionOption
EGY HTTP-befejezési beállítás értéke, amely jelzi, hogy a műveletet mikor kell befejezettnek tekinteni.
- cancellationToken
- CancellationToken
Lemondási jogkivonat, amelyet más objektumok vagy szálak használhatnak a lemondásról szóló értesítés fogadásához.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError
-vagy-
csak .NET keretrendszer: a kérés túllépte az időkorlátot.
A megadott kérelem URI-ja nem érvényes relatív vagy abszolút URI.
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
-vagy-
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a completionOption paraméter alapján fejeződik be a válasz egy részének vagy egészének (beleértve a tartalmat is) olvasása után.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.
A következőre érvényes:
GetAsync(Uri, HttpCompletionOption, CancellationToken)
GET kérés küldése a megadott URI-nak EGY HTTP-befejezési lehetőséggel és egy lemondási jogkivonattal aszinkron műveletként.
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)Paraméterek
- requestUri
- Uri
A kérelem URI-ja.
- completionOption
- HttpCompletionOption
EGY HTTP-befejezési beállítás értéke, amely jelzi, hogy a műveletet mikor kell befejezettnek tekinteni.
- cancellationToken
- CancellationToken
Lemondási jogkivonat, amelyet más objektumok vagy szálak használhatnak a lemondásról szóló értesítés fogadásához.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.
A kérés azért hiúsult meg, mert egy érvényes HTTP-választ kapott, például hálózati kapcsolati hiba, DNS-hiba, kiszolgálótanúsítvány-érvényesítési hiba vagy érvénytelen kiszolgálói válasz. A 8-.NET és újabb verziókban ennek okát HttpRequestError
-vagy-
csak .NET keretrendszer: a kérés túllépte az időkorlátot.
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
-vagy-
.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.
Megjegyzések
Ez a művelet nem tiltja le. A visszaadott Task<TResult> objektum a completionOption paraméter alapján fejeződik be a válasz egy részének vagy egészének (beleértve a tartalmat is) olvasása után.
Note
Időtúllépés esetén különböző kivételek jelennek meg a különböző .NET implementációk esetében.
- HttpRequestException minden alkalmazható .NET-keretrendszerverzióra vonatkozik.
- OperationCanceledException belső kivétel nélkül az összes alkalmazható .NET Core-verzióra vonatkozik.
- OperationCanceledException, amely egy TimeoutException fészkel, .NET 5-ös és újabb verziókra kerül.