HttpClient.GetStreamAsync 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。
| GetStreamAsync(Uri, CancellationToken) |
將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。 |
| GetStreamAsync(String, CancellationToken) |
將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。 |
| GetStreamAsync(Uri) |
將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。 |
| GetStreamAsync(String) |
將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。 |
作業不會封鎖。
將 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
用於取消作業的取消權杖。
傳回
工作物件，表示非同步作業。
例外狀況
requestUri 為 null。
要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。
僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
備註
這項作業不會封鎖。 傳回的Task< Stream>物件會在讀取回應標頭之後完成。 這個方法不會讀取或緩衝響應主體。
注意
如果逾時：
- .NET Framework 擲回 HttpRequestException。
- .NET Core 會擲回 ， TaskCanceledException 而不會有任何內部例外狀況。
- .NET 5 和更新版本會擲回 TaskCanceledException 巢狀 的 TimeoutException。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
將 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。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
將 GET 要求傳送至指定的 URI，並透過非同步作業，以資料流形式傳回回應內容。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);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。
傳回
工作物件，表示非同步作業。
例外狀況
requestUri 必須是絕對 URI，否則必須設定 BaseAddress。
要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。
僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。
備註
這項作業不會封鎖。 傳回的Task< Stream>物件會在讀取回應標頭之後完成。 這個方法不會讀取或緩衝響應主體。
注意
如果逾時：
- .NET Framework 擲回 HttpRequestException。
- .NET Core 會擲回 ， TaskCanceledException 而不會有任何內部例外狀況。
- .NET 5 和更新版本會擲回 TaskCanceledException 巢狀 的 TimeoutException。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
將 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);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。
傳回
工作物件，表示非同步作業。
例外狀況
requestUri 必須是絕對 URI，否則必須設定 BaseAddress。
要求因為根本問題而失敗，例如網路連線、DNS 失敗、伺服器憑證驗證或逾時 (僅限 .NET Framework)。
僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。
提供的要求 URI 不是有效的相對或絕對 URI。
備註
這項作業不會封鎖。 傳回的Task< Stream>物件會在讀取回應標頭之後完成。 這個方法不會讀取或緩衝響應主體。
注意
如果逾時：
- .NET Framework 擲回 HttpRequestException。
- .NET Core 會擲回 ， TaskCanceledException 而不會有任何內部例外狀況。
- .NET 5 和更新版本會擲回 TaskCanceledException 巢狀 的 TimeoutException。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
