HttpClient.GetByteArrayAsync Metódus

Definíció

Névtér:

System.Net.Http

Szerelvények:

netstandard.dll, System.Net.Http.dll

Küldjön get kérést a megadott URI-nak, és adja vissza a válasz törzsét bájttömbként egy aszinkron műveletben.

Túlterhelések

Name	Description
GetByteArrayAsync(String)	GET kérést küld a megadott URI-nak, és visszaadja a válasz törzsét bájttömbként egy aszinkron műveletben.
GetByteArrayAsync(Uri)	Küldjön get kérést a megadott URI-nak, és adja vissza a válasz törzsét bájttömbként egy aszinkron műveletben.
GetByteArrayAsync(String, CancellationToken)	GET kérést küld a megadott URI-nak, és visszaadja a válasz törzsét bájttömbként egy aszinkron műveletben.
GetByteArrayAsync(Uri, CancellationToken)	Küldjön get kérést a megadott URI-nak, és adja vissza a válasz törzsét bájttömbként egy aszinkron műveletben.

Megjegyzések

A művelet nem lesz blokkolva.

GetByteArrayAsync(String)

Forrás:

HttpClient.cs

GET kérést küld a megadott URI-nak, és visszaadja a válasz törzsét bájttömbként egy aszinkron műveletben.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync(string? requestUri);

member this.GetByteArrayAsync : string -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As String) As Task(Of Byte())

Paraméterek

requestUri

String

A kérelem URI-ja.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

InvalidOperationException

Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.

HttpRequestException

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-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

-vagy-

csak .NET keretrendszer: A kérés túllépte az időkorlátot.

OperationCanceledException

.NET Core és .NET 5-ös és újabb verziók esetén: A kérés időtúllépés miatt meghiúsult.

UriFormatException

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álasztörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

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.

GetByteArrayAsync(Uri)

Forrás:

HttpClient.cs

Küldjön get kérést a megadott URI-nak, és adja vissza a válasz törzsét bájttömbként egy aszinkron műveletben.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync(Uri? requestUri);

member this.GetByteArrayAsync : Uri -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As Uri) As Task(Of Byte())

Paraméterek

requestUri

Uri

A kérelem URI-ja.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

InvalidOperationException

Ez requestUri nem abszolút URI, és BaseAddress nincs beállítva.

HttpRequestException

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 az okokat HttpRequestError jelzi.

-vagy-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

-vagy-

csak .NET keretrendszer: A kérés túllépte az időkorlátot.

OperationCanceledException

.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álasztörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

Note

Időtúllépés esetén:

• .NET keretrendszer HttpRequestException dob.
• .NET Core belső kivétel nélkül OperationCanceledException dob.
• .NET 5-ös és újabb verziók OperationCanceledException fészkelnek be egy TimeoutException.

GetByteArrayAsync(String, CancellationToken)

Forrás:

HttpClient.cs

GET kérést küld a megadott URI-nak, és visszaadja a válasz törzsét bájttömbként egy aszinkron műveletben.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync(string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetByteArrayAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Byte())

Paraméterek

requestUri

String

A kérelem URI-ja.

cancellationToken

CancellationToken

A művelet megszakításához szükséges lemondási jogkivonat.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

HttpRequestException

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-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

UriFormatException

A megadott kérelem URI-ja nem érvényes relatív vagy abszolút URI.

OperationCanceledException

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álasztörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

Note

Időtúllépés esetén:

• .NET keretrendszer HttpRequestException dob.
• .NET Core belső kivétel nélkül OperationCanceledException dob.
• .NET 5-ös és újabb verziók OperationCanceledException fészkelnek be egy TimeoutException.

GetByteArrayAsync(Uri, CancellationToken)

Forrás:

HttpClient.cs

Küldjön get kérést a megadott URI-nak, és adja vissza a válasz törzsét bájttömbként egy aszinkron műveletben.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync(Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetByteArrayAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Byte())

Paraméterek

requestUri

Uri

A kérelem URI-ja.

cancellationToken

CancellationToken

A művelet megszakításához szükséges lemondási jogkivonat.

Válaszok

Task<Byte[]>

Az aszinkron műveletet képviselő tevékenységobjektum.

Kivételek

HttpRequestException

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-

A válasz állapotkódja kívül esik a 200–299 tartományon (ami a szabvány szerint sikerességet jelez).

OperationCanceledException

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álasztörzs elolvasása után befejeződik. Ez a művelet HttpResponseMessage.EnsureSuccessStatusCode belsőleg biztosítja, hogy a válasz állapotkódja a sikertartományban (200-299) legyen, és ha nem, akkor egy HttpRequestException értéket ad vissza. Egyes helyzetekben nagyobb mértékben kell szabályoznia, hogy mely állapotkódok tekinthetők sikeresnek; Előfordulhat például, hogy egy API mindig visszatér 200 OK. Ilyen esetekben javasoljuk, hogy manuálisan ellenőrizze, hogy egyezik-e StatusCode a várt értékkel.

Note

Időtúllépés esetén:

• .NET keretrendszer HttpRequestException dob.
• .NET Core belső kivétel nélkül OperationCanceledException dob.
• .NET 5-ös és újabb verziók OperationCanceledException fészkelnek be egy TimeoutException.