HttpClient.GetStreamAsync 方法

定義

將 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

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

傳回

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

例外狀況

requestUrinull

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

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

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

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

注意

如果逾時:

適用於

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

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

傳回

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

例外狀況

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

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

注意

如果逾時:

適用於

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);
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 和更新版本:要求因逾時而失敗。

備註

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

注意

如果逾時:

適用於

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);
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。

備註

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

注意

如果逾時:

適用於