DownloadDataCompletedEventArgs.Result Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Quelle:

WebClient.cs

Ruft die von einer DownloadDataAsync-Methode heruntergeladenen Daten ab.

public:
 property cli::array <System::Byte> ^ Result { cli::array <System::Byte> ^ get(); };

public byte[] Result { get; }

member this.Result : byte[]

Public ReadOnly Property Result As Byte()

Eigenschaftswert

Byte[]

Ein Byte-Array, das die heruntergeladenen Daten enthält.

Beispiele

Im folgenden Codebeispiel wird der Wert dieser Eigenschaft angezeigt.

void DownloadDataCallback( Object^ /*sender*/, DownloadDataCompletedEventArgs^ e )
{
   System::Threading::AutoResetEvent^ waiter = dynamic_cast<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 == nullptr )
      {
         array<Byte>^data = dynamic_cast<array<Byte>^>(e->Result);
         String^ textData = System::Text::Encoding::UTF8->GetString( data );
         Console::WriteLine( textData );
      }
   }
   finally
   {

      // Let the main application thread resume.
      waiter->Set();
   }

}

private 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();
    }
}

Private 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

Hinweise

Sie sollten die Error Eigenschaften und Cancelled überprüfen, bevor Sie die von dieser Eigenschaft zurückgegebenen Daten verwenden. Wenn der Wert der Error Eigenschaft ein Exception Objekt oder der Wert der Cancelled Eigenschaft ist, wurde trueder asynchrone Vorgang nicht ordnungsgemäß abgeschlossen, und der Wert der Result Eigenschaft ist ungültig.