HttpClient.TryGetStringAsync(Uri) 方法

  • 參考

定義

命名空間:
Windows.Web.Http
編輯

將 GET 要求傳送至指定的 URI，並透過非同步作業，以字串形式傳回回應內容。 如需 HttpClient 類別的程式設計指引和程式碼範例，請參閱 HttpClient 概念性主題。

public:
 virtual IAsyncOperationWithProgress<HttpGetStringResult ^, HttpProgress> ^ TryGetStringAsync(Uri ^ uri) = TryGetStringAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpGetStringResult, HttpProgress> TryGetStringAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpGetStringResult,HttpProgress> TryGetStringAsync(System.Uri uri);
function tryGetStringAsync(uri)
Public Function TryGetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpGetStringResult, HttpProgress)

參數

uri
Uri Uri

傳送要求的目標 URI。

傳回

IAsyncOperationWithProgress<HttpGetStringResult,HttpProgress>

物件，表示非同步作業。

屬性
RemoteAsyncAttribute

Windows 需求

裝置系列
Windows 10, version 1903 (已於 10.0.18362.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v8.0 引進)

備註

這項作業不會封鎖。 傳回的 IAsyncOperationWithProgress (HttpGetStringResult 和 HttpProgress) 會在讀取整個回應本文之後完成。

應用程式通常會使用 HttpClient 類別來下載並剖析文字。 HTTP 伺服器在 Content-Type 標頭中指定的字元編碼可能不符合 HTTP 回應本文的字元編碼， (XML 檔中的 XML 編碼，例如) 。 搭配文字使用 HttpClient 的其中一種方法是呼叫 TryGetStringAsync 方法，並將傳回的字串傳遞至文字剖析器。 不過，如果 Content-Type 不是字串可表示的類型，這可能會導致錯誤。 搭配 XML 剖析器使用 HttpClient 的可靠方式是呼叫 TryGetBufferAsync 方法，並剖析 「 < ？xml > 」 元素的緩衝區。 然後使用指定的字元編碼 (「 < xmlversion=」1.0「 encoding=」UTF-8「？ > 」，例如) 來剖析 HTTP 回應本文。 對於其他文字格式，可以使用類似的方法，其中應用程式會掃描 HTTP 回應本文的初始部分，以判斷所使用的字元編碼方式。

適用於

另請參閱