HttpClient.SendAsync 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.
HTTP-kérés küldése aszinkron műveletként.
Túlterhelések
| Name | Description |
|---|---|
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
HTTP-kérés küldése aszinkron műveletként. |
| SendAsync(HttpRequestMessage) |
HTTP-kérés küldése aszinkron műveletként. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
HTTP-kérés küldése aszinkron műveletként. |
| SendAsync(HttpRequestMessage, CancellationToken) |
HTTP-kérés küldése aszinkron műveletként. |
Megjegyzések
Ez a művelet nem tiltja le.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
HTTP-kérés küldése aszinkron műveletként.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Paraméterek
- request
- HttpRequestMessage
A küldendő HTTP-kérés üzenete.
- completionOption
- HttpCompletionOption
Amikor a művelet befejeződik (amint rendelkezésre áll egy válasz, vagy a teljes választartalom elolvasása után).
- cancellationToken
- CancellationToken
A művelet megszakításához szükséges lemondási jogkivonat.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Az request van null.
A kérelemüzenetet már elküldte a HttpClient példány.
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 paraméter értékétől completionOption függően a visszaadott Task<TResult> objektum azonnal befejeződik, amint elérhető a válasz, vagy a teljes válasz, beleértve a tartalmat is.
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.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Send(HttpRequestMessage, HttpCompletionOption)kiadott kivételeket: .
A következőre érvényes:
SendAsync(HttpRequestMessage)
HTTP-kérés küldése aszinkron műveletként.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request);override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)Paraméterek
- request
- HttpRequestMessage
A küldendő HTTP-kérés üzenete.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Az request van null.
A kérelemüzenetet már elküldte a HttpClient példány.
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 elolvasása után befejeződik, beleértve a tartalmat is. 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.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Send(HttpRequestMessage)kiadott kivételeket: .
A következőre érvényes:
SendAsync(HttpRequestMessage, HttpCompletionOption)
HTTP-kérés küldése aszinkron műveletként.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Paraméterek
- request
- HttpRequestMessage
A küldendő HTTP-kérés üzenete.
- completionOption
- HttpCompletionOption
Amikor a művelet befejeződik (amint rendelkezésre áll egy válasz, vagy a teljes választartalom elolvasása után).
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Az request van null.
A kérelemüzenetet már elküldte a HttpClient példány.
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 paraméter értékétől completionOption függően a visszaadott Task<TResult> objektum azonnal befejeződik, amint elérhető a válasz, vagy a teljes válasz, beleértve a tartalmat is.
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.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Send(HttpRequestMessage, HttpCompletionOption)kiadott kivételeket: .
A következőre érvényes:
SendAsync(HttpRequestMessage, CancellationToken)
HTTP-kérés küldése aszinkron műveletként.
public:
override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Paraméterek
- request
- HttpRequestMessage
A küldendő HTTP-kérés üzenete.
- cancellationToken
- CancellationToken
A művelet megszakításához szükséges lemondási jogkivonat.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
Az request van null.
A kérelemüzenetet már elküldte a HttpClient példány.
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 teljes válasz elolvasása után befejeződik, beleértve a tartalmat is. 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.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Send(HttpRequestMessage)kiadott kivételeket: .