HttpClient.GetStreamAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.

Przeciążenia

GetStreamAsync(Uri, CancellationToken)	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(String)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.

Uwagi

Operacja nie będzie blokować.

GetStreamAsync(Uri, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Stream)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

cancellationToken

CancellationToken

Token anulowania w celu anulowania operacji.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Wartość requestUri to null.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Task< Stream> zostanie ukończony po odczytaniu nagłówków odpowiedzi. Ta metoda nie odczytuje ani nie buforuje treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetStreamAsync(String, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Stream)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

cancellationToken

CancellationToken

Token anulowania w celu anulowania operacji.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Task< Stream> zostanie ukończony po odczytaniu nagłówków odpowiedzi. Ta metoda nie odczytuje ani nie buforuje treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetStreamAsync(Uri)

Źródło:

HttpClient.cs

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri);

member this.GetStreamAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri) As Task(Of Stream)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Task< Stream> zostanie ukończony po odczytaniu nagłówków odpowiedzi. Ta metoda nie odczytuje ani nie buforuje treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetStreamAsync(String)

Źródło:

HttpClient.cs

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako strumień w operacji asynchronicznej.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri);

member this.GetStreamAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String) As Task(Of Stream)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

UriFormatException

Podany identyfikator URI żądania nie jest prawidłowym względnym lub bezwzględnym identyfikatorem URI.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Task< Stream> zostanie ukończony po odczytaniu nagłówków odpowiedzi. Ta metoda nie odczytuje ani nie buforuje treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.