OpenReadCompletedEventArgs.Result プロパティ

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

OpenReadCompletedEventArgs.Result プロパティ

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

DownloadDataAsync メソッドによってダウンロードされたデータを格納している読み取り可能なストリームを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Result As Stream

Visual Basic (使用法)

Dim instance As OpenReadCompletedEventArgs
Dim value As Stream

value = instance.Result

C#

public Stream Result { get; }

C++

public:
property Stream^ Result {
    Stream^ get ();
}

J#

/** @property */
public Stream get_Result ()

JScript

public function get Result
 () : Stream

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

解説

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

使用例

このプロパティによって返されるストリームを使用するコード例を次に示します。

Visual Basic

Public Shared Sub OpenReadCallback2(ByVal
 sender As Object, ByVal
 e As OpenReadCompletedEventArgs)

    Dim reply As Stream = Nothing
    Dim s As StreamReader = Nothing

    Try

        reply = CType(e.Result, Stream)
        s = New StreamReader(reply)
        Console.WriteLine(s.ReadToEnd())
    Finally

        If Not s Is Nothing
 Then

            s.Close()
        End If

        If Not reply Is
 Nothing Then

            reply.Close()
        End If
    End Try
End Sub

C#

public static void OpenReadCallback2
 (Object sender, OpenReadCompletedEventArgs e)
{
    Stream reply = null;
    StreamReader s = null;

    try
    {
        reply = (Stream)e.Result;
        s = new StreamReader (reply);
        Console.WriteLine (s.ReadToEnd ());
    }
    finally
    {
        if (s != null)
        {
            s.Close ();
        }

        if (reply != null)
        {
            reply.Close ();
        }
    }
}

プラットフォーム

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

参照

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