HttpClient.GetStringAsync(Uri) 方法

定義

命名空間:

Windows.Web.Http

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

public:
 virtual IAsyncOperationWithProgress<Platform::String ^, HttpProgress> ^ GetStringAsync(Uri ^ uri) = GetStringAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<winrt::hstring, HttpProgress> GetStringAsync(Uri const& uri);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<string,HttpProgress> GetStringAsync(System.Uri uri);

function getStringAsync(uri)

Public Function GetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of String, HttpProgress)

參數

uri

Uri Uri

傳送要求的目標 URI。

傳回

IAsyncOperationWithProgress<String,HttpProgress>

IAsyncOperationWithProgress<Platform::String,HttpProgress>

IAsyncOperationWithProgress<winrt::hstring,HttpProgress>

表示非同步作業的 物件。

屬性

RemoteAsyncAttribute

備註

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

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

以下是此函式擲回的例外狀況。

E_INVALIDARG

uri參數是 Visual Basic) 中 Nothing的Null參考 (。

例外狀況處理

呼叫此方法時，您必須撰寫程式碼來處理例外狀況。 例外狀況可能是因為參數驗證錯誤、名稱解析失敗和網路錯誤所造成。 網路錯誤 (連線中斷、連線失敗和 HTTP 伺服器失敗的例外狀況，例如，隨時可能會發生) 。 這些錯誤會造成擲出例外狀況。 如果應用程式未處理，例外狀況可能會導致整個應用程式由執行時間終止。 如需如何處理例外狀況的詳細資訊，請參閱 處理網路應用程式中的例外狀況。

另請參閱

• IAsyncOperationWithProgress<TResult,TProgress>
• Uri
• HttpProgress
• HttpClient