HttpClient.GetStreamAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。

多載

GetStreamAsync(Uri, CancellationToken)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。
GetStreamAsync(String, CancellationToken)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。
GetStreamAsync(Uri)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。
GetStreamAsync(String)	將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。

備註

作業不會封鎖。

GetStreamAsync(Uri, CancellationToken)

將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。

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)

參數

requestUri

Uri

傳送要求的目標 URI。

cancellationToken

CancellationToken

用於取消作業的取消權杖。

傳回

Task<Stream>

工作物件，表示非同步作業。

例外狀況

ArgumentNullException

requestUri 為 null。

HttpRequestException

要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

備註

這項作業不會封鎖。 傳回的工作< 資料流程 >物件會在讀取回應標頭之後完成。 這個方法不會讀取或緩衝回應主體。

注意

如果逾時：

• .NET Framework擲回 HttpRequestException 。
• .NET Core 會擲回 ， TaskCanceledException 而不會有任何內部例外狀況。
• .NET 5 和更新版本的 會擲回 TaskCanceledException 巢狀 的 TimeoutException 。

GetStreamAsync(String, CancellationToken)

將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。

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)

參數

requestUri

String

傳送要求的目標 URI。

cancellationToken

CancellationToken

用於取消作業的取消權杖。

傳回

Task<Stream>

工作物件，表示非同步作業。

備註

這項作業不會封鎖。 傳回的工作< 資料流程 >物件會在讀取回應標頭之後完成。 這個方法不會讀取或緩衝回應主體。

注意

如果逾時：

• .NET Framework擲回 HttpRequestException 。
• .NET Core 會擲回 ， TaskCanceledException 而不會有任何內部例外狀況。
• .NET 5 和更新版本的 會擲回 TaskCanceledException 巢狀 的 TimeoutException 。

GetStreamAsync(Uri)

將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。

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)

參數

requestUri

Uri

傳送要求的目標 URI。

傳回

Task<Stream>

工作物件，表示非同步作業。

例外狀況

InvalidOperationException

requestUri 必須是絕對 URI，否則必須設定 BaseAddress。

HttpRequestException

要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

備註

這項作業不會封鎖。 傳回的工作< 資料流程 >物件會在讀取回應標頭之後完成。 這個方法不會讀取或緩衝回應主體。

注意

如果逾時：

• .NET Framework擲回 HttpRequestException 。
• .NET Core 會擲回 ， TaskCanceledException 而不會有任何內部例外狀況。
• .NET 5 和更新版本的 會擲回 TaskCanceledException 巢狀 的 TimeoutException 。

GetStreamAsync(String)

將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。

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)

參數

requestUri

String

傳送要求的目標 URI。

傳回

Task<Stream>

工作物件，表示非同步作業。

例外狀況

InvalidOperationException

requestUri 必須是絕對 URI，否則必須設定 BaseAddress。

HttpRequestException

要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

UriFormatException

提供的要求 URI 不是有效的相對或絕對 URI。

備註

這項作業不會封鎖。 傳回的工作< 資料流程 >物件會在讀取回應標頭之後完成。 這個方法不會讀取或緩衝回應主體。

注意

如果逾時：

• .NET Framework擲回 HttpRequestException 。
• .NET Core 會擲回 ， TaskCanceledException 而不會有任何內部例外狀況。
• .NET 5 和更新版本的 會擲回 TaskCanceledException 巢狀 的 TimeoutException 。