DownloadStringCompletedEventArgs クラス

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

ソース:

WebClient.cs

DownloadStringCompleted イベントのデータを提供します。

public ref class DownloadStringCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs

public class DownloadStringCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type DownloadStringCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class DownloadStringCompletedEventArgs
Inherits AsyncCompletedEventArgs

継承

Object

EventArgs

AsyncCompletedEventArgs

DownloadStringCompletedEventArgs

例

次のコード例では、文字列を非同期にダウンロードする方法を示します。

// Sample call : DownloadStringInBackground2 ("http://www.contoso.com/GameScores.html");
void DownloadStringInBackground2( String^ address )
{
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   // Specify that the DownloadStringCallback2 method gets called
   // when the download completes.
   client->DownloadStringCompleted += gcnew DownloadStringCompletedEventHandler( DownloadStringCallback2 );
   client->DownloadStringAsync( uri );
}

// Sample call : DownloadStringInBackground2 ("http://www.contoso.com/GameScores.html");
public static void DownloadStringInBackground2(string address)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    // Specify that the DownloadStringCallback2 method gets called
    // when the download completes.
    client.DownloadStringCompleted += new DownloadStringCompletedEventHandler(DownloadStringCallback2);
    client.DownloadStringAsync(uri);
}

'  Sample call : DownloadStringInBackground2 ("http:' www.contoso.com/GameScores.html")
Public Shared Sub DownloadStringInBackground2(ByVal address As String)

    Dim client As WebClient = New WebClient()

    '  Specify that the DownloadStringCallback2 method gets called
    '  when the download completes.
    AddHandler client.DownloadStringCompleted, AddressOf DownloadStringCallback2
                Dim uri as Uri = New Uri(address)
    client.DownloadStringAsync(uri)
End Sub

ダウンロードが完了すると、次のメソッドが呼び出されます。

void DownloadStringCallback2( Object^ /*sender*/, DownloadStringCompletedEventArgs^ e )
{

   // If the request was not canceled and did not throw
   // an exception, display the resource.
   if (  !e->Cancelled && e->Error == nullptr )
   {
      String^ textString = dynamic_cast<String^>(e->Result);
      Console::WriteLine( textString );
   }
}

private static void DownloadStringCallback2(Object sender, DownloadStringCompletedEventArgs e)
{
    // If the request was not canceled and did not throw
    // an exception, display the resource.
    if (!e.Cancelled && e.Error == null)
    {
        string textString = (string)e.Result;

        Console.WriteLine(textString);
    }
}

Private Shared Sub DownloadStringCallback2(ByVal sender As Object, ByVal e As DownloadStringCompletedEventArgs)

    '  If the request was not canceled and did not throw
    '  an exception, display the resource.
    If e.Cancelled = False AndAlso e.Error Is Nothing Then

        Dim textString As String = CStr(e.Result)
        Console.WriteLine(textString)
    End If
End Sub

注釈

このクラスのインスタンスは に DownloadStringCompletedEventHandler渡されます。

プロパティ

Cancelled	非同期操作がキャンセルされたかどうかを示す値を取得します。 (継承元 AsyncCompletedEventArgs)
Error	非同期操作中に発生したエラーを示す値を取得します。 (継承元 AsyncCompletedEventArgs)
Result	DownloadStringAsync メソッドによってダウンロードされたデータを取得します。
UserState	非同期タスクの一意の識別子を取得します。 (継承元 AsyncCompletedEventArgs)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
RaiseExceptionIfNecessary()	非同期操作が失敗した場合は、ユーザー指定の例外を発生させます。 (継承元 AsyncCompletedEventArgs)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)