DownloadDataCompletedEventArgs.Result プロパティ

.NET Framework クラス ライブラリ リファレンス

DownloadDataCompletedEventArgs.Result プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

DownloadDataAsync メソッドによってダウンロードされたデータを取得します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Result As Byte()

Visual Basic (使用法)

Dim instance As DownloadDataCompletedEventArgs
Dim value As Byte()

value = instance.Result

C#

public byte[] Result { get; }

C++

public:
property array<unsigned char>^ Result {
    array<unsigned char>^ get ();
}

J#

/** @property */
public byte[] get_Result ()

JScript

public function get Result
 () : byte[]

プロパティ値
ダウンロードされたデータが格納されている Byte 配列。

解説

このプロパティによって返されるデータを使用する前に、Error プロパティおよび Cancelled プロパティを確認する必要があります。Error プロパティの値が Exception オブジェクトであるか、Cancelled プロパティの値が true である場合は、非同期の操作が適切に完了していないため、Result プロパティの値は有効ではありません。

使用例

このプロパティの値を表示するコード例を次に示します。

Visual Basic

Public Shared Sub DownloadDataCallback(ByVal
 sender As Object, ByVal
 e As DownloadDataCompletedEventArgs)

    Dim waiter As System.Threading.AutoResetEvent
 = CType(e.UserState, System.Threading.AutoResetEvent)

    Try

        '  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 data() As Byte
 = CType(e.Result, Byte())
            Dim textData As String
 = System.Text.Encoding.UTF8.GetString(data)

            Console.WriteLine(textData)
        End If
    Finally

        '  Let the main application thread resume.
        waiter.Set()
    End Try
End Sub

C#

public static void DownloadDataCallback
 (Object sender, DownloadDataCompletedEventArgs e)
{
    System.Threading.AutoResetEvent waiter = (System.Threading.AutoResetEvent)e.UserState;

    try
    {
        // If the request was not canceled and did not throw
        // an exception, display the resource.
        if (!e.Cancelled && e.Error == null)
        {
            byte[] data = (byte[])e.Result;
            string textData = System.Text.Encoding.UTF8.GetString
 (data);

            Console.WriteLine (textData);
        }
    }
    finally
    {
        // Let the main application thread resume.
        waiter.Set ();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DownloadDataCompletedEventArgs クラス
DownloadDataCompletedEventArgs メンバ
System.Net 名前空間