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)