エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

WebClient.DownloadStringAsync メソッド (Uri, Object)

2013/12/12

指定した Uri にあるリソースを文字列としてダウンロードします。

Namespace:  System.Net
アセンブリ:  System.Net (System.Net.dll 内)

public void DownloadStringAsync(
	Uri address,
	Object userToken
)

パラメーター

address
型: System.Uri
ダウンロードされるリソースの場所。
userToken
型: System.Object
非同期タスクにユーザー指定の識別子を提供します。

例外条件
ArgumentNullException

address パラメーターが null です。

OutOfMemoryException

プログラムの実行の継続に十分なメモリがありません。

StackOverflowException

ネストされたメソッド呼び出しが多く含まれすぎているため、実行スタックがオーバーフローしました。

ThreadAbortException

スレッドを破棄する Thread.Abort メソッドが呼び出されています。

このメソッドは、GET メソッドを使用して指定したリソースを取得します。リソースは非同期的にダウンロードされます。ダウンロードが完了すると、DownloadStringCompleted イベントが発生します。ダウンロードされた文字列は、DownloadStringCompletedEventArgsResult プロパティで使用できます。最初の文字列のダウンロード操作が完了しないうちに同じ WebClient オブジェクトに対して DownloadStringAsync メソッドを再度呼び出すことはできません。これを行うと、例外が発生します。

CancelAsync メソッドを使用すると、未完了の非同期操作をキャンセルできます。

BaseAddress プロパティが空の文字列でなく、アドレスに絶対 URI が含まれていなければ、アドレスを相対 URI とする必要があります。この相対 URI が BaseAddress と結合され、要求するデータの絶対 URI が形成されます。

この userToken は、非同期操作の完了時に呼び出すメソッドに渡す AsyncCompletedEventArgsUserState プロパティとして取得してください。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2015 Microsoft